Crear entornos

En este tema se explica cómo crear entornos para Apigee hybrid. Para obtener una introducción, consulta Acerca de los entornos y los grupos de entornos.

Acerca de la creación de entornos

El proceso de creación de un entorno consta de dos pasos:

  • Crea un entorno en el plano de gestión mediante la interfaz de usuario o una API de Apigee.
  • Añade la configuración de ese entorno al archivo de anulaciones y aplícala al clúster.

Los pasos para añadir un entorno se describen en Paso 5: Añade un entorno y Especifica las anulaciones de configuración.

Cómo crear un entorno

  1. Crea uno o varios entornos en la interfaz de usuario de Apigee o con la API Create environments. Para ver los pasos básicos, consulta el paso 5: Añade un entorno.
  2. Añade una nueva definición de entorno a la propiedad envs[] de tu archivo de anulaciones. Ten en cuenta que la propiedad es una matriz, por lo que puedes añadir más de una definición de entorno. Asigna al nuevo entorno el mismo nombre que el entorno que has creado en la interfaz de usuario. 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 los cambios al clúster. Aplica los cambios a cada entorno por orden.
    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 monitorizar 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 de tu entorno es único, puede ser el mismo que ENV_NAME. Sin embargo, si el entorno y el grupo de entornos tienen el mismo nombre, asegúrate de introducir un nombre de lanzamiento 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 la sección Tres conceptos importantes de la documentación de Helm.

    El entorno de test:

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

    El entorno de prod:

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

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