Crie ambientes

Este tópico explica como criar novos ambientes. 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 que atribuiu ao ambiente criado 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. Adicione uma propriedade virtualhosts que mapeie o respetivo routingRules para os ambientes. 
    virtualhosts:
  - name: default
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: test
  4. Aplicar quaisquer alterações ao cluster. Se 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 alterar apenas a propriedade virtualhosts, aplique essas alterações de configuração com a flag --settings: 

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

Para mais informações sobre a configuração de anfitriões virtuais, incluindo como configurar várias regras de encaminhamento de basepath, consulte o artigo Configurar anfitriões virtuais. Para ver uma lista completa dos elementos de configuração do ambiente, consulte envs na referência da propriedade Configuration.