Información sobre los entornos

Un entorno proporciona un contexto aislado o un "entorno aislado" para ejecutar proxies de API. En una misma organización, puedes crear varios entornos. Para obtener más información, consulta Acerca de los entornos y los grupos de entornos.

El siguiente código muestra un ejemplo de configuración de anulaciones en el que se definen varios entornos. Ten en cuenta que los entornos prod y test tienen alias de host diferentes: 

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
...
  • 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
     
    virtualhosts:
  - name: external
    hostAliases: ["apiprod.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: prod

    Supongamos que un proxy con la ruta base /foo1 se despliega en el entorno test. Puedes llamar al proxy de esta forma: 

    curl -k https://api.example.com/foo1

    Cuando esta llamada llega al ingress, este sabe que debe enviarla al procesador de mensajes asociado al entorno test, que gestiona la solicitud.

    Del mismo modo, si foo1 también se ha implementado en el entorno prod, puedes hacer una solicitud proxy como esta al alias de host apiprod.mydomain.net: 

    curl -k https://apiprod.example.com/foo1

    La llamada se enruta a través del ingreso al MP asociado a ese host.

    Antipatrón: despliega todos tus proxies en un entorno híbrido.

    Práctica recomendada: Crea varios entornos y despliega un número limitado de proxies en cada uno. Puedes crear reglas de enrutamiento que especifiquen a qué entornos se deben enrutar las rutas base de proxy de API concretas. Para obtener más información, consulta Configuración de hosts virtuales.

    Limitar el número de implementaciones de proxy

    En el caso de los entornos híbridos, el hecho de que muchos entornos puedan compartir el mismo host virtual significa que debes pensar detenidamente cómo gestionas tus implementaciones de proxy en un entorno concreto. En los entornos híbridos, lo más recomendable es crear varios entornos y desplegar un número limitado de proxies en cada uno.

    ¿Cuántos proxies debes implementar en un entorno? No hay una respuesta concreta a esta pregunta, pero en la siguiente tabla se ofrecen directrices generales sobre por qué es recomendable limitar el número de proxies desplegados en cada entorno y qué debes tener en cuenta al gestionar los despliegues de proxies:

    Problema que debes tener en cuenta Descripción
    Tiempo de arranque del procesador de mensajes Existe una correlación directa entre el tiempo que tarda en iniciarse un procesador de mensajes y el número de proxies implementados en ese procesador. En un entorno de Kubernetes con escalado automático, un aumento del tiempo de arranque puede ser un problema. Cuantos más proxies se implementen en el MP, más tiempo tardará en iniciarse si necesita escalarse o recrearse.
    Rendimiento de escalado Si tienes varios proxies desplegados en un entorno y uno de ellos recibe mucho tráfico, de forma que se escala automáticamente con frecuencia, todos los proxies de ese entorno se escalarán con él. El efecto en el rendimiento de escalar varios proxies con un solo proxy de alto tráfico puede ser un problema.
    Vecino ruidoso Si tienes varios proxies desplegados en el mismo entorno y uno de ellos falla, todos los proxies del entorno se desactivarán mientras se reinician los MPs. Si limitas el número de proxies implementados en un entorno, minimizas el impacto de un fallo de un solo proxy.

    Referencia de configuración del entorno

    Para ver una lista completa de los elementos de configuración del entorno, consulta envs en la referencia de la propiedad de configuración.

    Trabajar con entornos

    Para obtener más información sobre la configuración, consulta los siguientes temas: