Criar ambientes

Neste tópico, explicamos como criar novos ambientes para a Apigee híbrida. 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 e adicionar um ambiente são descritas na Etapa 5: adicionar um ambiente e Especificar modificaçõ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. Aplique todas as alterações ao cluster:

    Helm

    Com os gráficos do Helm, aplique as alterações a cada ambiente em sequência.

    O ambiente test:

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

    O ambiente prod:

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

    apigeectl

    Com apigeectl, é possível aplicar as alterações a cada ambiente individualmente com a sinalização --env ENV_NAME ou a todos os ambientes ao mesmo tempo com a sinalização --all-envs. Por exemplo:

    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --all-envs

Para mais informações sobre a configuração do host virtual, 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.