Passo 5: crie um grupo de ambientes

Certifique-se de que a sua organização com capacidade híbrida 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 e indica que o Aprovisionamento está pendente:

Em alguns momentos, muda para aprovisionado:

No entanto, ainda não terminou. Também tem de adicionar o novo ambiente ao ficheiro overrides.yaml do tempo de execução, mas primeiro tem de instalar o tempo de execução. Por isso, vamos com calma.

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%

echo ${PROJECT_ID}
echo ${ENV_NAME}
echo ${ENV_DISPLAY_NAME}
echo ${ORG_NAME}
echo ${ENV_DESCRIPTION}

Se necessário, crie ou redefina as seguintes variáveis de ambiente para os elementos do ambiente. Vai usar a seguinte variável no comando para a criar:

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

  export ENV_NAME=environment_name

• ENV_DISPLAY_NAME (Obrigatório) é o nome intuitivo do seu ambiente. Este valor não tem de ser exclusivo e pode incluir espaços e carateres especiais. Por exemplo, "O meu ambiente de exemplo".

  ENV_DISPLAY_NAME=friendly_name

• ORG_NAME (Obrigatório) é o ID da sua organização. Certifique-se de que definiu a variável de ambiente ORG_NAME a partir do Passo 4: crie uma organização:

  echo $ORG_NAME

• ENV_DESCRIPTION (Opcional) são informações sobre o ambiente que quer usar como lembrete da respetiva finalidade. Por exemplo, "Example environment for Apigee Hybrid instructions".

  ENV_DESCRIPTION=description_text

O exemplo seguinte mostra a estrutura do pedido que cria um ambiente, através do 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"

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. Este processo pode demorar vários minutos.

É apresentada a vista Vista geral dos grupos de ambientes, com todos os grupos de ambientes criados:

É 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

echo $DOMAIN

Este é o nome do anfitrião que todos os proxies implementados em ambientes dentro deste grupo vão usar. 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 não estiver definido, crie-o com o domínio que planeia usar para a sua instalação híbrida do Apigee. Por exemplo:

export DOMAIN=domain-name.com