Crea entornos

En este artículo, se explica cómo crear entornos nuevos. 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. Agrega una propiedad virtualhosts que mapee 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 cualquier cambio en el clúster. Si cambiaste las propiedades envs[] y virtualhosts[], aplica los cambios con el siguiente comando:
    apigeectl apply -f overrides-file.yaml -c synchronizer,udca,runtime

    Si solo cambias la propiedad virtualhosts, aplica 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 del host virtual, incluida la forma de configurar varias reglas de enrutamiento de ruta base, 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.