Criar ambientes

Neste tópico, explicamos como criar novos ambientes. Para uma introdução, consulte Sobre ambientes e grupos de ambiente.

Sobre a criação do ambiente

A criação do ambiente é um processo de duas etapas:

  • Crie um ambiente no plano de gerenciamento usando a IU ou uma API Apigee.
  • Adicione a configuração desse ambiente ao arquivo de modificações e aplique ao cluster.

As etapas para adicionar um ambiente são descritas na Etapa 5: adicionar um ambiente e Especificar substituições de configuração.

Como criar um ambiente

  1. Crie um ou mais ambientes novos na IU da Apigee ou com a API Create Environments. Para ver as etapas básicas, consulte Etapa 5: adicionar um ambiente.

  2. Adicione uma nova definição de ambiente à propriedade envs[] no arquivo de modificações. Observe que a propriedade é uma matriz. Portanto, você pode adicionar mais de uma definição de ambiente a ela. Dê ao novo ambiente o mesmo nome que você criou na interface do usuário. Por exemplo, a configuração a seguir 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. Adicione uma propriedade virtualhosts que mapeie o routingRules para o(s) ambiente(s). 
    virtualhosts:
  - name: default
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: test
  4. Aplique todas as alterações ao cluster. Se você alterou as propriedades envs[] e virtualhosts[], aplique as alterações com o seguinte comando: 
    apigeectl apply -f overrides-file.yaml -c synchronizer,udca,runtime

    Se você alterar apenas a propriedade virtualhosts, aplique essas alterações de configuração com a sinalização --settings: 

    apigeectl apply -f overrides-file.yaml --settings virtualhosts

Para mais informações sobre a configuração do host virtual, incluindo como configurar várias regras de roteamento do caminho base, consulte Configurar hosts virtuais. Para uma lista completa dos elementos de configuração do ambiente, consulte ambientes na Referência da propriedade de configuração.