Acerca de los entornos

Un entorno proporciona un contexto aislado o una “zona de pruebas” para ejecutar proxies de API. En una sola organización, puedes crear varios entornos. Para obtener más información, consulta Información acerca de los entornos y grupos de entornos.

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

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
...

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

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 implementa en la prueba del entorno. Puedes llamar al proxy de la siguiente manera:

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

Cuando esta llamada llega a la entrada, la entrada sabe enviarla al procesador de mensajes asociado con el entorno test, que controla la solicitud.

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

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

Y la llamada se enruta a través de la entrada al MP asociado con ese host.

NOTA En una solicitud a un proxy de API, la entrada compara el encabezado Host de la solicitud entrante con la lista de alias de host a fin de determinar qué host virtual administra la solicitud. Los comandos curl, los navegadores y muchas otras utilidades establecen de forma automática el encabezado Host con el dominio de la solicitud. Si por algún motivo, tu app no configura el encabezado Host de forma automática, debes configurarlo de forma manual.

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

Prácticas recomendadas: Crea varios entornos e implementa una cantidad limitada de proxies en cada uno. Puedes crear reglas de enrutamiento que especifiquen a qué entornos enrutar rutas de base del proxy de API específicas. Para obtener más detalles, consulta Configura hosts virtuales.

Limita la cantidad de implementaciones de proxy

Para los entornos híbridos, el hecho de que muchos entornos puedan compartir el mismo host virtual significa que debes pensar con cuidado sobre cómo administras tus implementaciones de proxy en cualquier entorno determinado. En el híbrido, se recomienda crear múltiples entornos e implementar una cantidad limitada de proxies en cada uno.

¿Cuántos proxies debería implementar en un entorno? No hay una respuesta establecida para esta pregunta. Sin embargo, en la siguiente tabla se proporciona orientación general sobre por qué es recomendable limitar la cantidad de proxies implementados en cada entorno y lo que debes tener en cuenta cuando administras las implementaciones de proxy:

Problema que se debe tener en cuenta	Descripción
Tiempo de inicio del procesador de mensajes	Existe una correlación directa entre el tiempo que toma el procesador de mensajes (MP) y la cantidad de proxies que se implementan en ese MP. En un entorno de Kubernetes con ajuste de escala automático, un aumento en el tiempo de inicio puede ser un problema. Cuantos más proxies se implementen en el MP, más tiempo le tomará aparecer a ese archivo en caso de que se deba escalar o volver a crear.
Escalamiento de rendimiento	Si tienes varios proxies implementados en un entorno y uno de ellos recibe mucho tráfico para que ajuste la escala de forma automática con frecuencia, todos los proxies de ese entorno escalarán con él. El efecto de rendimiento del escalamiento de varios proxies con un solo proxy de tráfico alto puede ser un problema.
Vecino ruidoso	Si tienes varios proxies implementados en el mismo entorno y uno falla, todos los proxies del entorno se borrarán mientras se reinician los MP. Cuando limitas la cantidad de proxies implementados en un entorno, minimizas el impacto de una falla de proxy único.

Referencia de configuración del entorno

Para obtener 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: