Como trabalhar com grupos de ambiente

Apigee no console do Cloud

Para criar um novo grupo de ambiente na Apigee no console do Cloud:

1. Abra a interface da Apigee no console do Cloud em um navegador.
2. Selecione Gerenciamento > Ambientes no painel de navegação à esquerda.
3. No painel Ambientes, selecione Grupos de ambientes.
4. Clique em + Criar grupo de ambiente.
5. 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.

   • Hostames: uma lista de nomes de host que podem ser usados para chamar proxies. Cada nome de host precisa estar em uma linha separada.

     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.
6. Clique em Criar.

Apigee clássica

Para criar um novo grupo de ambiente na interface clássica da Apigee, faça o seguinte:

1. Na IU da Apigee, selecione Administrador > Ambientes > Grupos.
2. Clique em +Grupo de ambiente:

   

   A caixa de diálogo Add a Environment Group é exibida.

3. Insira um nome para o novo grupo de ambiente:

   

   O nome só pode conter letras minúsculas, números e hífens. Além disso, ele precisa começar com uma letra, ter pelo menos dois caracteres e não pode terminar com um hífen. Os nomes válidos incluem my-env-group e prod2.

4. Clique em Adicionar.

   A Apigee cria um novo grupo de ambiente. Essa operação geralmente é muito rápida.

   Em uma operação bem-sucedida, a Apigee confirma que o grupo foi criado com um banner que tem a seguinte aparência:

   

   A Apigee também atribui um nome de host padrão ao novo grupo.

5. Opcional: atribua outros nomes de host ao novo grupo clicando em create nesse grupo.

   A Apigee exibe o painel Detalhes do grupo de ambientes:

   

6. Adicione nomes de host ao campo Hostnames. Cada nome de host precisa estar em uma linha separada.

7. Clique em Save quando terminar.

   Você pode adicionar e remover nomes de host a essa lista a qualquer momento usando o mesmo procedimento.

API Apigee

Para criar um novo grupo de ambiente usando a API Apigee, envie uma solicitação POST para a API de criação de grupos de ambiente. Antes de chamar a API, verifique se você tem um token válido, conforme descrito em Como receber um token de acesso do OAuth 2.0.

O seguinte exemplo de comando curl mostra a sintaxe para criar um novo grupo:

curl -i $TOKEN -X POST \
  https://apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups?name=new-group-name

Ao especificar o nome do novo grupo, é preciso usar somente letras minúsculas, números e hífens (a-z, A-Z e -). Não é possível usar letras maiúsculas ou qualquer caractere especial, exceto hífens. Também é necessário começar com uma letra minúscula.

Se você não especificar outros parâmetros, esse comando criará um novo grupo sem nomes de host atribuídos a ele.

Também é possível atribuir nomes de host ao criar o grupo especificando-os como uma matriz no corpo da solicitação.

O exemplo a seguir cria um novo grupo my-group e atribui três novos nomes de host ao novo grupo:

curl -i $TOKEN -X POST \
  https://apigee.googleapis.com/v1/organizations/org_name/envgroups?name=my-group \
  -d '{ \
    "hostnames": ["server1.mycompany.com", "server2.mycompany.com", "10.1.142.8"] \
  }'

Posteriormente, você poderá alterar os nomes dos hosts na lista enviando uma solicitação PATCH à API de grupos de ambiente de patch.

Apigee no console do Cloud

Para adicionar um ambiente a um grupo de ambientes na Apigee no Console do Cloud, faça o seguinte:

1. Crie o ambiente, conforme descrito em Como criar ambientes.
2. Na interface da Apigee no console do Cloud, selecione Gerenciamento > Ambientes no painel de navegação à esquerda.
3. No painel Ambientes, selecione Grupos de ambientes.
4. Na linha do grupo de ambiente, clique no menu de três pontos em Ações e selecione Editar.
5. No painel Editar grupo de ambiente, em Ambientes (opcional), selecione o ambiente que você quer adicionar ao grupo.
6. Clique em Atualizar.

Apigee clássica

Para adicionar um ambiente a um grupo de ambientes na interface clássica da Apigee, faça o seguinte:

1. Crie o ambiente, conforme descrito em Como criar ambientes.
2. Na IU da Apigee, selecione Administrador > Ambientes > Grupos.
3. Em Não atribuído, para conferir uma lista de ambientes que não fazem parte de um grupo de ambientes:

   

   Observe quais ambientes não estão atribuídos como você quer atribuí-los.

4. Clique em create ao lado do grupo de ambientes a que você quer adicionar ambientes.

   O painel Detalhes do grupo de ambientes é exibido:

   

5. Para adicionar um novo ambiente a esse grupo, clique em + na lista Ambientes.

   O painel Adicionar ambiente será exibido:

   

6. Selecione o ambiente que você quer adicionar ao grupo e clique em Adicionar.

   O Apigee adiciona o ambiente ao grupo.

API Apigee

Para adicionar um novo ambiente a um grupo de ambiente usando a API da Apigee, envie uma solicitação POST para a API de anexo de grupo de ambiente, conforme o exemplo a seguir:

curl -H "Authorization: Bearer $TOKEN" -X POST
  "https://apigee.googleapis.com/v1/organizations/my-org/envgroups/test-group/attachments"
  -d '{
    "name": "my-attachment",
    "environment": "test"
  }'

Em que:

• Em que $TOKEN está definido como seu token de acesso OAuth 2.0, conforme descrito em Como receber um token de acesso OAuth 2.0.
• O corpo da solicitação contém o nome do anexo e o nome do novo ambiente.

O corpo da solicitação contém uma instância de um recurso EnvironmentGroupAttachment, que é um wrapper simples em torno de um único ambiente.

Se for bem-sucedida, a resposta conterá detalhes sobre o novo anexo, incluindo a data e hora em que foi criada; Por exemplo:

{
  "name": "my-attachment",
  "environment": "test"
  "createdAt": "42"
}

Apigee no console do Cloud

Para remover um ambiente de um grupo da Apigee no Console do Cloud, faça o seguinte:

1. Na interface da Apigee no console do Cloud, selecione Gerenciamento > Ambientes no painel de navegação à esquerda.
2. No painel Ambientes, selecione Grupos de ambientes.
3. Na linha do grupo de ambiente, clique no menu de três pontos em Ações e selecione Editar.
4. No painel Editar grupo de ambiente, em Ambientes (opcional), desmarque o ambiente que você quer remover do grupo de ambientes.
5. Clique em Atualizar.

Apigee clássica

Para remover um ambiente de um grupo de ambiente na interface clássica da Apigee, faça o seguinte:

1. Na IU da Apigee, selecione Administrador > Ambientes > Visão geral.
2. Selecione o ambiente que você quer remover.
3. No painel Grupos, mova o cursor para o fim da linha do grupo do qual você quer remover o ambiente e clique em .

API Apigee

Para remover um ambiente de um grupo de ambiente usando a API da Apigee, use o método delete no recurso EnvironmentGroupAttachment para excluir o anexo correspondente ao ambiente.

Apigee no console do Cloud

Para excluir um grupo de ambiente da Apigee no Console do Cloud, faça o seguinte:

1. Na interface da Apigee no console do Cloud, selecione Gerenciamento > Ambientes no painel de navegação à esquerda.
2. No painel Ambientes, selecione Grupos de ambientes.
3. Na linha do grupo de ambiente, clique no menu de três pontos em Ações e selecione Excluir.

Apigee clássica

Para excluir um grupo de ambiente na interface clássica da Apigee, faça o seguinte:

1. Na IU da Apigee, selecione Administrador > Ambientes > Grupos.
2. Mova o cursor para o painel do grupo que você quer excluir.
3. Clique no ícone .

API Apigee

Para excluir um grupo de ambiente usando a API da Apigee, use o método delete no recurso EnvironmentGroup.

Apigee no console do Cloud

Para adicionar um nome de host a um grupo de ambiente na Apigee no Console do Cloud:

1. Na interface da Apigee no console do Cloud, selecione Gerenciamento > Ambientes no painel de navegação à esquerda.
2. No painel Ambientes, selecione Grupos de ambientes.
3. Na linha do grupo de ambiente, clique no menu de três pontos em Ações e selecione Editar.
4. No painel Editar grupo de ambiente, em Nomes do host, insira o nome do host que você quer adicionar ao grupo.
5. Clique em Atualizar.

Apigee clássica

Para adicionar um nome de host a um grupo de ambiente na interface clássica da Apigee, faça o seguinte:

1. Na IU da Apigee, selecione Administrador > Ambientes > Grupos.

2. Passe o cursor sobre o card do grupo e selecione create.

   O painel Detalhes do grupo de ambientes é exibido:

   

3. No campo Hostnames, digite os novos hosts.
4. Clique em Salvar para adicionar os novos hosts ao grupo.

API Apigee

Para adicionar nomes de host a um grupo de ambiente usando a API Apigee, envie uma solicitação PATCH para a API de grupos de ambiente de patch. Defina o parâmetro updateMask como hostnames e especifique a lista inteira de nomes de host que você quer: o valor desse campo na solicitação substitui a lista atual.

No exemplo a seguir, definimos os nomes de host para o ambiente de teste:

curl -H "Authorization: Bearer $TOKEN" -X PATCH
  "https://apigee.googleapis.com/v1/organizations/my-org/envgroups/test-group?hostnames=updateMask"
  -d '{
    "name": "my-hostnames",
    "hostnames": [
      "test-1.example.com",
      "test-2.example.com",
      "test-3.example.com"
    ]
  }'

Em que:

• Em que $TOKEN está definido como seu token de acesso OAuth 2.0, conforme descrito em Como receber um token de acesso OAuth 2.0.
• O payload da solicitação especifica um nome para a matriz de anexos do nome do host, além da matriz de nomes.

Se a solicitação for bem-sucedida, a resposta conterá um recurso Operação.