Crie ambientes

Este tópico explica como criar novos ambientes para o Apigee Hybrid. Para uma introdução, consulte o artigo Acerca dos ambientes e dos grupos de ambientes.

Acerca da criação de ambientes

A criação de um ambiente é um processo de dois passos:

• Crie um ambiente no plano de gestão através da IU ou de uma API Apigee.
• Adicione a configuração para esse ambiente ao ficheiro de substituições e aplique-a ao cluster.

Os passos para adicionar um ambiente são descritos em Adicionar e configurar um ambiente explicados no Passo 5: adicione um ambiente e Especifique substituições de configuração.

Como criar um ambiente

1. Crie um ou mais novos ambientes na IU do Apigee ou com a API Create environments. Para os passos básicos, consulte o Passo 5: adicione um ambiente.

2. Adicione uma nova definição de ambiente à propriedade envs[] no ficheiro de substituições. Tenha em atenção que a propriedade é uma matriz. Por isso, pode adicionar mais do que uma definição de ambiente à mesma. Atribua ao novo ambiente o mesmo nome do ambiente que criou na IU. Por exemplo, a seguinte configuração define dois ambientes: test e prod:

   namespace: my-namespace
   org: my-organization
   ...
   envs:
     - name: test
       serviceAccountPaths:
         synchronizer: "your_keypath/synchronizer-manager-service-account.json
         udca: "your_keypath/analytic-agent-service-account.json
   
     - name: prod
       serviceAccountPaths:
         synchronizer: "your_keypath/synchronizer-manager-service-account.json
         udca: "your_keypath/analytic-agent-service-account.json
   ...

3. Aplicar quaisquer alterações ao cluster. Aplicar as alterações a cada ambiente em sequência.

   helm upgrade ENV_RELEASE_NAME apigee-env/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --set env=ENV_NAME \
     -f OVERRIDES_FILE \
     --dry-run=server
   

   ENV_RELEASE_NAME é um nome usado para acompanhar a instalação e as atualizações do gráfico apigee-env. Os nomes de lançamentos do Helm têm de ser exclusivos na sua instalação híbrida do Apigee. Se o nome do ambiente for exclusivo, pode ser igual ao ENV_NAME. No entanto, se tiver o mesmo nome para o ambiente e o grupo de ambientes, certifique-se de que introduz um nome de lançamento do Helm exclusivo para cada um. Por exemplo, se ambos tiverem o nome dev, pode usar algo como dev-env-release e dev-envgroup-release.

   Para mais informações sobre lançamentos no Helm, consulte Três conceitos importantes na documentação do Helm.

   O test ambiente:

   helm upgrade test-release apigee-env/ \
     --namespace apigee \
     --atomic \
     --set env=test \
     -f OVERRIDES_FILE.yaml
   

   O prod ambiente:

   helm upgrade prod-release apigee-env/ \
     --namespace apigee \
     --set env=prod \
     --atomic \
     -f OVERRIDES_FILE.yaml
   

Para mais informações sobre a configuração do anfitrião virtual, consulte o artigo Configure anfitriões virtuais. Para ver uma lista completa dos elementos de configuração do ambiente, consulte envs na referência da propriedade Configuration.