Crea entornos

En este tema, se explica cómo crear entornos nuevos de Apigee Hybrid. Para obtener una introducción, consulta Información sobre los entornos y grupos de entornos.

Acerca de la creación del entorno

La creación del entorno es un proceso de dos pasos:

  • Crea un entorno en el plano de administración mediante la IU o una API de Apigee.
  • Agrega la configuración para ese entorno a tu archivo de anulaciones y aplícalo al clúster.

Los pasos para agregar un entorno se describen en agregar y configurar un entorno que se explican en el Paso 5: Agregar un entorno y en Especifica anulaciones de configuración.

Cómo crear un entorno

  1. Crea uno o más entornos nuevos en la IU de Apigee o con la API de creación de entornos. Para conocer los pasos básicos, consulta Paso 5: Agrega un entorno.

  2. Agrega una definición de entorno nueva a la propiedad envs[] en tu archivo de anulaciones. Ten en cuenta que la propiedad es un arreglo. Por lo tanto, puedes agregarle más de una definición de entorno. Otorga el mismo nombre al entorno nuevo que creaste en la IU. Por ejemplo, la siguiente configuración define dos entornos: test y 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. Aplica cualquier cambio en el clúster:
    Helmapigeectl

    Con los gráficos de Helm, aplica los cambios a cada entorno en secuencia con los siguientes comandos.

    Por ejemplo:

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

      ENV_RELEASE_NAME es un nombre que se usa para hacer un seguimiento de la instalación y las actualizaciones del gráfico apigee-env. Los nombres de las versiones de Helm deben ser únicos en tu instalación híbrida de Apigee. Si el nombre del entorno es único, puede ser el mismo que ENV_NAME. Sin embargo, si tienes el mismo nombre para tu entorno y grupo de entornos, asegúrate de ingresar un nombre de versión de Helm único para cada uno. Por ejemplo, si ambos se llaman dev, puedes usar algo como dev-env-release y dev-envgroup-release.

      Para obtener más información sobre las versiones de Helm, consulta Tres conceptos importantes en la documentación de Helm.

    El entorno test:

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

    El entorno prod:

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

    Con apigeectl, puedes aplicar los cambios a cada entorno de forma individual con la marca --env ENV_NAME o a todos los entornos al mismo tiempo con la marca --all-envs. Por ejemplo:

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

Para obtener más información sobre la configuración del host virtual, consulta Configura hosts virtuales. Para obtener una lista completa de los elementos de configuración del entorno, consulta envs en la referencia de la propiedad de configuración.