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 mudanças a cada ambiente em sequência com os comandos abaixo.

    Exemplo:

    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 os upgrades do gráfico apigee-env. Os nomes de lançamento do Helm precisam ser exclusivos na instalação híbrida da Apigee. Se o nome do ambiente for exclusivo, ele poderá ser o mesmo que ENV_NAME. No entanto, se você tiver o mesmo nome para o ambiente e o grupo de ambiente, insira um nome de versão exclusivo para cada um deles. Por exemplo, se ambos forem nomeados dev, use algo como dev-env-release e dev-envgroup-release.

      Para mais informações sobre as versões no Helm, consulte Três grandes conceitos na documentação do Helm.

    O ambiente test:

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

    O ambiente prod:

    helm upgrade prod-release 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.