Crear entornos

En este tema se explica cómo crear entornos. 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 le has dado 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. Añade una propiedad virtualhosts que asigne su routingRules a los entornos.

   virtualhosts:
     - name: default
       hostAliases: ["api.example.com"]
       sslCertPath: ./certs/fullchain.pem
       sslKeyPath: ./certs/privkey.pem
       routingRules:
         - env: test

4. Aplica los cambios al clúster. Si has cambiado las propiedades envs[] y virtualhosts[], aplica los cambios con el siguiente comando:

   apigeectl apply -f overrides-file.yaml -c synchronizer,udca,runtime

   Si solo cambia la propiedad virtualhosts, aplique esos cambios de configuración con la marca --settings:

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

Para obtener más información sobre la configuración de hosts virtuales, incluido cómo configurar varias reglas de enrutamiento de ruta base, consulta el artículo 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.