Esta página foi traduzida pela API Cloud Translation.

Etapa 3: criar um grupo de ambientes

Nesta etapa, você criará um ambiente e um grupo de ambiente.

Na Apigee, os proxies de API são implantados em ambientes, que fornecem contextos isolados para seus proxies. Os ambientes são organizados em grupos de ambiente, que fornecem nomes do host para todos os proxies implantados nos ambientes do grupo. É preciso ter pelo menos um ambiente e pelo menos um grupo de ambientes. Para saber mais, consulte Sobre ambientes e grupos de ambiente.

Criar um ambiente

Crie o ambiente antes de criar o grupo. É possível criar um ambiente usando a IU da Apigee ou a API. Use a IU para conhecer as etapas a seguir.

IU da Apigee

Para criar um novo ambiente na interface da Apigee:

Na interface da Apigee, acesse Gerenciamento > Ambientes.
Acessar "Ambientes"
No painel Ambientes, clique em + Criar ambiente.
No painel Criar um ambiente, insira o seguinte:
- Nome: é o nome do ambiente programático. O Nome não pode ser alterado após a criação.
  
  O nome precisa ter entre dois e 32 caracteres, que podem ser letras minúsculas, números ou hifens. O nome precisa começar com uma letra e não pode terminar com um hífen. O nome precisa ser diferente de qualquer outro nome de ambiente da organização.
- Nome de exibição: o nome do ambiente exibido na IU.
- Descrição: opcional. Uma descrição do ambiente.
- Instância: deixe o campo Instance em branco. As instâncias não se aplicam às instalações da Apigee híbrida.
- Grupo de ambientes: deixe o campo Grupo de ambientes em branco por enquanto. Você criará um grupo de ambiente no próximo procedimento.
- Tipo de implantação: para a maioria das instalações da Apigee híbrida, selecione a opção para implantar proxies de API individuais. Você tem a opção de implantar um arquivo do ambiente de configuração do proxy de API. Para mais informações, consulte Tipos de implantação compatíveis.
  Observação: depois de criado, o tipo de implantação usado com este ambiente não pode ser alterado.
Clique em Criar.

Após a conclusão, o novo ambiente é exibido na tabela no painel Ambientes.

API Apigee

Para criar um ambiente com a API Create Environments, siga as seguintes etapas:

Abra um terminal no dispositivo que você está usando para gerenciar a Apigee.
Na linha de comando, receba as credenciais de autenticação de gcloud. Use o comando a seguir:
Linux / MacOS
```
export TOKEN=$(gcloud auth print-access-token)
```
Para verificar se o token foi preenchido, use echo, como mostra o exemplo a seguir:
```
echo $TOKEN
```
Isso exibirá seu token como uma string codificada.
Windows
```
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
```
Para verificar se o token foi preenchido, use echo, como mostra o exemplo a seguir:
```
echo %TOKEN%
```
Isso exibirá seu token como uma string codificada.
Crie a seguinte variável de ambiente:
Linux / MacOS
```
export ENV_NAME="YOUR_ENV_NAME"
```
Windows
```
set ENV_NAME="YOUR_ENV_NAME"
```
Em que:
- ENV_NAME (Necessário) O nome do ambiente pode conter letras minúsculas, traços e números e precisa começar com uma letra minúscula. Esse nome será usado como o identificador e não poderá ser alterado após a criação do ambiente.

Chame a seguinte API da Apigee:

Sem residência de dados

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"

Residência dos dados

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

Em uma solicitação de criação bem-sucedida, a API Environments 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, a Apigee começou a criar o novo ambiente. Portanto, seu estado é IN_PROGRESS.

Verifique se o ambiente foi criado:

Sem residência de dados

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

Residência dos dados

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

Em uma solicitação de criação bem-sucedida, a API Environments responde com uma mensagem semelhante a esta:

[
  "your-environment-name"
]

Criar um grupo de ambiente

Agora crie um grupo de ambiente e atribua o ambiente criado nele.

IU da Apigee

Para criar um novo grupo de ambiente na IU da Apigee:

Na interface da Apigee, acesse Gerenciamento > Ambientes > Grupos de ambientes.
Acessar "Grupos de ambientes"
No painel Ambientes, selecione Grupos de ambientes.
Clique em + Criar grupo de ambiente.
Digite o seguinte:
- Nome do grupo de ambientes: um nome para o grupo de ambientes. O nome precisa começar e terminar com um caractere alfanumérico. Ele pode ter até 63 caracteres alfanuméricos e hífens. O nome precisa ser diferente de qualquer nome de grupo de ambiente na organização.
- Hostnames: uma lista de nomes de host que podem ser usados para chamar proxies. Cada nome de host precisa estar em uma linha separada.
  
  Observação: os nomes atribuídos a um grupo de ambiente precisam ser exclusivos a esse grupo. Eles não podem ser usados por outros grupos de ambiente.
  
  Você também pode clicar em Configurar o balanceador de carga do Google com estes domínios. Isso abre a página Balanceamento de carga no Console do Cloud, onde é possível configurar o balanceamento de carga dos nomes de host.
- Ambientes: uma lista opcional de ambientes para incluir no grupo.
Clique em Criar.

API Apigee

Para criar um grupo de ambiente usando a API da Apigee:

Na linha de comando, receba as credenciais de autenticação de gcloud usando o comando a seguir:
Linux / MacOS
```
TOKEN=$(gcloud auth print-access-token)
```
Windows
```
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
```
Crie as variáveis de ambiente a seguir.
Linux / MacOS
```
export DOMAIN="YOUR_DOMAIN"
export ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
```
Windows
```
 data-terminal-prefix=">">set ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
 data-terminal-prefix=">">set DOMAIN="YOUR_DOMAIN"
```
Em que:
- DOMAIN (Obrigatório) Este é o nome do host que todos os proxies implantados nos ambientes deste grupo vão usar. Este deve ser um domínio que você gerencia. O endereço pode ser o próprio domínio, comoexample.com, ou pode incluir um subdomínio como my-proxies.example.com. Se você não tiver um domínio gerenciado, insira um marcador por enquanto. É possível alterar o endereço do domínio depois.
- ENV_GROUP (Necessário) O nome do ambiente pode conter letras minúsculas, traços e números e precisa começar com uma letra minúscula. Esse nome será usado como o identificador e não poderá ser alterado após a criação

Crie o grupo de ambiente:

Sem residência de dados

curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
   -d '{
     "name": "'"$ENV_GROUP"'",
     "hostnames":["'"$DOMAIN"'"]
   }' \
   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

Residência dos dados

curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
   -d '{
     "name": "'"$ENV_GROUP"'",
     "hostnames":["'"$DOMAIN"'"]
   }' \
   "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

Atribua o ambiente ao novo grupo:

Sem residência de dados

curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
   -d '{
     "environment": "'"$ENV_NAME"'",
   }' \
   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

Residência dos dados

curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
   -d '{
     "environment": "'"$ENV_NAME"'",
   }' \
   "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

Verifique se o grupo de ambiente foi criado com sucesso usando o seguinte comando CURL:

Sem residência de dados

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

Residência dos dados

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

Em uma solicitação de criação bem-sucedida, a API Environments Group responde com uma mensagem semelhante a esta:

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

Busque os anexos mais recentes do grupo de ambiente recém-criado usando o seguinte comando CURL:

Sem residência de dados

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

Residência dos dados

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

O anexo e a criação do grupo de ambiente foram bem-sucedidos se o resultado mostrar um valor de hash exclusivo, conforme mostrado no exemplo de resposta abaixo:


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

Próxima etapa

Para continuar a instalação, vá para a Parte 2: configuração do ambiente de execução híbrido.

Etapa 3: criar um grupo de ambientes Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Criar um ambiente

IU da Apigee

API Apigee

Linux / MacOS

Windows

Linux / MacOS

Windows

Sem residência de dados

Residência dos dados

Sem residência de dados

Residência dos dados

Criar um grupo de ambiente

IU da Apigee

API Apigee

Linux / MacOS

Windows

Linux / MacOS

Windows

Sem residência de dados

Residência dos dados

Sem residência de dados

Residência dos dados

Sem residência de dados

Residência dos dados

Sem residência de dados

Residência dos dados

Próxima etapa

Etapa 3: criar um grupo de ambientes