Etapa 5: 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 híbrida da Apigee ou a CLI. Use a IU para conhecer as etapas a seguir.

IU do híbrido da Apigee

Para acessar a IU híbrida e adicionar um ambiente, siga as seguintes etapas:

  1. Abra a IU da Apigee. Se esta for a primeira vez que você faz login, o híbrido exibirá uma caixa de diálogo de consentimento. Se você precisar escolher entre mais de uma conta, escolha a que pertence ao projeto criado na Etapa 2: criar um projeto do Google Cloud. Clique em Permitir.

    2. Seu navegador acessa a página de destino principal da IU do híbrido:

    A página de destino na IU do híbrido da Apigee, que consiste na navegação à esquerda e em imagens grandes que são links.

  2. Verifique se a organização ativada para acesso híbrido está selecionada na lista suspensa da organização. Se não estiver selecionada, selecione-o na lista suspensa, conforme mostrado no exemplo a seguir:

    Uma lista de organizações com a ativação híbrida

  3. Clique em Administrador > Ambientes > Visão geral.

    Menu da IU do híbrido da Apigee mostrando "Administrador", "Ambientes" e "Visão geral" expandido

    A visualização Ambientes será exibida, sem ambientes (ainda):

    A visualização "Ambientes", em branco (sem ambientes)

  4. Clique em +Ambiente.

    A caixa de diálogo de Novo ambiente é exibida:

    A nova caixa de diálogo de ambiente

  5. Digite as informações a seguir na caixa de diálogo Novo ambiente:
    1. Nome de exibição (obrigatório): um nome amigável do ambiente usado na IU. Por exemplo, "Meu primeiro ambiente" ou "teste". Ao contrário do Nome do ambiente, o Nome de exibição pode incluir caracteres maiúsculos e outros.
    2. Environment name (obrigatório): é o nome programático do ambiente. também conhecido como ID do ambiente.

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

      O Nome de exibição e o Nome do ambiente podem ser diferentes.

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

    A Apigee cria o novo ambiente e indica que Provisionamento pendente:

    Mensagem de status de provisionamento pendente

    Em alguns momentos, ele muda para provisionado:

    Uma nova mensagem foi provisionada para o novo ambiente

    No entanto, ainda não acabou. Também é necessário adicionar o novo ambiente ao arquivo overrides.yaml do ambiente de execução. No entanto, primeiro é necessário instalar o ambiente de execução, então vamos continuar.

CLI da gcloud

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

  1. Abra um terminal no dispositivo que você está usando para gerenciar a Apigee.

  2. 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.
  3. Verifique se você tem as variáveis de ambiente necessárias definidas com os seguintes comandos: 
    echo ${PROJECT_ID}
echo ${ENV_NAME}
echo ${ENV_DISPLAY_NAME}
echo ${ORG_NAME}
echo ${ENV_DESCRIPTION}

    Se necessário, crie ou redefina as variáveis de ambiente a seguir para os elementos do ambiente. Use a seguinte variável no comando para criá-la:

    • ENV_NAME (Obrigatório) é o ID programático do seu ambiente. 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 
      export ENV_NAME=environment_name
    • ENV_DISPLAY_NAME (Obrigatório) é o nome fácil de usar do ambiente. Esse valor não precisa ser exclusivo e pode incluir espaços e caracteres especiais. Por exemplo, "Meu exemplo de ambiente". 
      ENV_DISPLAY_NAME=friendly_name
    • ORG_NAME (Obrigatório) é o ID da organização. Verifique se você definiu a variável de ambiente ORG_NAME na Etapa 4: criar uma organização: 
      echo $ORG_NAME
    • ENV_DESCRIPTION (Opcional) são as informações sobre o ambiente que você quer usar como um lembrete da finalidade dele. Por exemplo, "Exemplo de ambiente para instruções do híbrido do Apigee". 
      ENV_DESCRIPTION=description_text
  4. Envie uma solicitação POST autenticada à API Create environments.

    No exemplo a seguir, mostramos a estrutura de solicitação que cria um ambiente usando o seguinte comando:

    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
    "name": "'"$ENV_NAME"'",
    "displayName": "'"$ENV_DISPLAY_NAME"'",
    "description": "'"$ENV_DESCRIPTION"'"
  }'   "https://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. Esse processo pode levar vários minutos.

Criar um grupo de ambiente

Agora crie um grupo de ambiente e atribua o ambiente criado nele. Grupos de ambiente permitem agrupar ambientes e fornecer os nomes do host para rotear os proxies implantados nos ambientes do grupo. É preciso criar pelo menos um grupo de ambiente e atribuir ao menos um nome de host ao grupo. Para uma visão geral dos grupos de ambientes, consulte Sobre ambientes e grupos de ambiente.

IU do híbrido da Apigee

Para criar um grupo de ambiente usando a IU da Apigee, siga estas etapas:

  1. Abra a IU da Apigee.

    2. Seu navegador acessa a página de destino principal da IU do híbrido.

  2. Verifique se a organização ativada para acesso híbrido está selecionada na lista suspensa da organização. Se não estiver, selecione-a na lista suspensa.
  3. Clique em Administrador > Ambientes > Grupos.

    A visualização Visão geral dos grupos de ambientes é exibida com todos os grupos de ambientes criados:

    Visualização "Grupos de ambientes", com todos os grupos criados

  4. Clique em +Grupo de ambiente.

    A caixa de diálogo Adicionar grupo de ambiente é exibida.

    Caixa de diálogo "Adicionar grupo de ambiente" mostrando o campo "Nome" em branco

  5. Insira um nome e clique em Adicionar.

  6. Mantenha o cursor do mouse sobre o grupo de ambiente recém-criado e clique em Editar .

    Adicione um nome de host que será usado por todas as proxies implementadas nos ambientes do grupo. Precisa ser um domínio que você tenha acesso de gerenciamento. O nome do host pode ser o próprio domínio, como example.com, ou pode incluir um subdomínio como my-proxies.example.com.

    Se você precisar registrar um domínio, consulte um registrador de domínios, como o Google Domains.

    7. Janela "Editar grupo de ambiente" mostrando nenhum ambiente atribuído

  7. Clique em Adicionar (+).
  8. A caixa de diálogo Adicionar ambiente é exibida.

    9. Caixa de diálogo "Adicionar ambiente" listando os ambientes disponíveis

  9. Selecione um ambiente na lista e clique em Adicionar.

CLI da gcloud

Para criar um grupo de ambiente usando a linha de comando, siga as seguintes etapas:

  1. Na linha de comando, receba as credenciais de autenticação de gcloud. Use 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
  2. Verifique se a variável de ambiente DOMAIN está definida conforme indicado no exemplo a seguir: 
    echo $DOMAIN

    É o nome do host que todos os proxies implantados nos ambientes deste grupo usarão. Precisa ser um domínio que você tenha acesso de gerenciamento. O nome do host pode ser o próprio domínio, como example.com, ou pode incluir um subdomínio como my-proxies.example.com.

    Caso ele não esteja definido, crie-o com o domínio que você planeja usar para a instalação do híbrido da Apigee. Por exemplo: 

    export DOMAIN=domain-name.com
  3. Verifique se a variável de ambiente ENV_NAME está definida como o ambiente recém-criado nas etapas anteriores. Por exemplo: 
    echo $ENV_NAME
  4. Crie uma variável de ambiente para o nome do grupo de ambiente pretendido. Por exemplo: 
    export ENV_GROUP=environment-group-name
  5. Crie o grupo de ambiente com o seguinte comando: 
    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"
  6. Atribua o ambiente ao novo grupo com o seguinte comando: 
    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"

Próxima etapa

Para continuar com a instalação, consulte Instalação no momento da execução: antes de começar.