Passo 3: crie um grupo de ambientes

Certifique-se de que a sua organização está selecionada na lista pendente de organizações. Se não estiver selecionado, selecione-o na lista pendente, como mostra o exemplo seguinte:

É apresentada a vista Ambientes, sem ambientes (ainda):

É apresentada a caixa de diálogo Novo ambiente:

1. Nome a apresentar (obrigatório): um nome amigável para o ambiente que é usado na IU. Por exemplo, "O meu primeiro ambiente" ou "teste". Ao contrário do nome do ambiente, o nome a apresentar pode incluir letras maiúsculas e outros carateres especiais.
2. Nome do ambiente (obrigatório): o nome programático do ambiente, também conhecido como o ID do ambiente.

   Por exemplo, "my-environment" ou "test".

   O Nome a apresentar e o Nome do ambiente podem ser diferentes.

3. Descrição (opcional): informações adicionais sobre o ambiente que quer adicionar como lembrete da finalidade do ambiente. Por exemplo, "Criado durante a instalação inicial".

O Apigee cria o novo ambiente.

Agora, tem de criar um grupo de ambientes e adicionar o seu novo ambiente ao grupo.

Na linha de comando, obtenha as suas credenciais de autenticação gcloud através do seguinte comando:

export TOKEN=$(gcloud auth print-access-token)

echo $TOKEN

for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

echo %TOKEN%

export ENV_NAME="YOUR_ENV_NAME"

set ENV_NAME="YOUR_ENV_NAME"

Onde:

• ENV_NAME (Obrigatório) O nome do ambiente pode conter letras minúsculas, travessões e números e tem de começar por uma letra minúscula. Este nome vai ser usado como identificador e não pode ser alterado após a criação do ambiente.

curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
    "name": "'"$ENV_NAME"'"
  }'   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

Num pedido de criação bem-sucedido, a API Environments deve responder com uma mensagem semelhante à seguinte:

{
  "name": "organizations/hybrid-example/operations/c2aee040-7e79-4fd4-b0cf-79ca1b7098a8",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "INSERT",
    "targetResourceName": "organizations/hybrid-example/environments/example-env",
    "state": "IN_PROGRESS"
  }
}

Como a propriedade state na resposta indica, o Apigee começou a criar o novo ambiente, pelo que o respetivo estado é IN_PROGRESS.

curl -H "Authorization: Bearer $TOKEN" \
          "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

Num pedido de criação bem-sucedido, a API Environments responde com uma mensagem semelhante à seguinte:

[
  "your-environment-name"
]

É apresentada a vista Environment Groups Overview (Vista geral dos grupos de ambientes):

É apresentada a caixa de diálogo Adicionar um grupo de ambientes.

Passe o cursor do rato sobre o grupo de ambientes recém-criado e, de seguida, clique em Editar edit.

Adicione um nome de anfitrião que todos os proxies implementados em ambientes dentro deste grupo vão usar. Este deve ser um domínio ao qual tem acesso de gestão. O nome do anfitrião pode ser o próprio domínio, como example.com, ou pode incluir um subdomínio, como my-proxies.example.com.

Se precisar de registar um domínio, consulte uma entidade de registo de domínios, como o Google Domains.

Na linha de comando, obtenha as suas credenciais de autenticação gcloud através do seguinte comando:

TOKEN=$(gcloud auth print-access-token)

for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

export DOMAIN="YOUR_DOMAIN"
export ENV_GROUP="YOUR_ENVIRONMENT_GROUP"

 data-terminal-prefix=">">set ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
 data-terminal-prefix=">">set DOMAIN="YOUR_DOMAIN"

Onde:

• DOMAIN (Obrigatório) Este é o nome do anfitrião que todos os proxies implementados em ambientes dentro deste grupo vão usar. Este deve ser um domínio que gere. O endereço pode ser o próprio domínio, como example.com, ou pode incluir um subdomínio, como my-proxies.example.com. Se não tiver um domínio gerido, pode introduzir um marcador de posição por agora. Pode alterar o endereço do domínio mais tarde.
• ENV_GROUP (Obrigatório) O nome do ambiente pode conter letras minúsculas, travessões e números e tem de começar por uma letra minúscula. Este nome vai ser usado como identificador e não pode ser alterado após a criação.

curl -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

Num pedido de criação bem-sucedido, a API Environments Group responde com uma mensagem semelhante à seguinte:

      {
        "environmentGroups": [
          {
            "name": "your_envgroup_hybrid",
            "hostnames": [
              "apigee.hybrid.com"
            ],
            "createdAt": "1677826235324",
            "lastModifiedAt": "1677826235324",
            "state": "ACTIVE"
          }
        ]
      }
    

curl -H "Authorization: Bearer $TOKEN" \ 
  "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

A criação e a associação do grupo de ambientes foram bem-sucedidas se o resultado mostrar um valor hash exclusivo, conforme apresentado no resultado da resposta de exemplo abaixo:

     
        {
          "environmentGroupAttachments": [
            {
              "name": "c27046d1-b83e-4cba-xxxx-caaa660b2bd6",
              "environment": "your_envtest_hybrid",
              "createdAt": "1677826263567",
              "environmentGroupId": "your_envgroup_hybrid"
            }
          ]
        }