Acerca de los entornos y grupos de entornos

En esta sección, se describen los entornos y grupos de entornos.

Descripción general

Un entorno es un contexto de ejecución en tiempo de ejecución para los proxies de API y los flujos compartidos en una organización. Debe implementar un proxy de API en un entorno para poder acceder a él. Puedes implementar un proxy de API en un entorno único o en varios.

Cada entorno está limitado a 50 proxies de API implementados y flujos compartidos (combinados).

Un grupo de entornos (a veces llamado envgroup en la API de Apigee) es el mecanismo básico para definir cómo se enrutan las solicitudes a entornos individuales. Debes definir los nombres de host en tus grupos de entornos (no en entornos individuales), y Apigee enruta las solicitudes a los entornos dentro de un grupo mediante esas definiciones de nombre de host.

Los entornos deben ser miembros de un grupo de entorno antes de que puedas acceder a los recursos definidos dentro de ellos. En otras palabras, debe asignar un entorno a un grupo antes de poder usarlo.

La agrupación lógica de entornos por grupo de entorno proporciona los siguientes beneficios:

• Administración centralizada de nombres de host: los grupos de entorno proporcionan un lugar centralizado para administrar los nombres de host.
• Estadísticas globales: Con los grupos, puedes analizar los errores si observas los informes de un grupo de entorno completo a la vez en lugar de entornos individuales.
• Evitación de conflictos: Cuando agrupas entornos, puedes asegurarte de que las rutas base para tus entornos no existan con el mismo nombre de host.

Puntos clave

En la siguiente tabla, se enumeran los puntos importantes para tener en cuenta sobre entornos, organizaciones y grupos de entornos:

Elemento	Reglas
Organizaciones	Puede contener varios grupos de entornos Debe tener al menos un grupo de entornos
Entornos	Debe estar en al menos un grupo de entornos Puede estar en más de un grupo. Comparte los nombres de host con todos los demás entornos en el mismo grupo
Grupos de entornos	Puede tener varios nombres de host Contener uno o más entornos Los nombres de host asignados a un grupo deben ser únicos para ese grupo (no pueden usarse otros grupos)

Usuarios híbridos de Apigee: Cada grupo de entornos que crees con un entorno conectado se debe incluir en todos los archivos de anulación en los que se usa el entorno.

Para obtener información sobre la cantidad de grupos de entornos por organización y la cantidad de entornos por grupo de entornos que puedes tener, consulta los límites.

Ejemplos

En las siguientes secciones, se muestran formas comunes en las que los entornos se estructuran dentro de los grupos de entornos.

Un grupo de entornos y un entorno

La estructura más simple es un grupo de entornos único que tiene un solo entorno. Esto es común en las organizaciones que están evaluando el producto o que aún no configuraron la infraestructura de prueba o de análisis, y que no han implementado proxies en producción.

Varios entornos en un solo grupo

Una organización puede contener varios grupos de entornos. Por ejemplo, puedes definir los grupos de entorno dev, test y prod en una organización y asignar cada uno de esos grupos a un solo nombre de host (o dirección IP. ). Dentro de cada grupo, puede haber uno o más entornos:

Grupos de entornos alineados con acceso

Debido a que puedes asignar el mismo entorno a más de un grupo, puedes organizar tus entornos por acceso. Por ejemplo, puedes hacer que tus entornos de producción sean accesibles en un solo grupo de entorno interno, pero limitar el acceso a algunos de ellos en un grupo público, que sería abierto a Internet:

Grupos de entornos alineados con unidades de negocios

Con un conjunto más grande y maduro de proxies implementados de forma activa, es común alinear los grupos de entornos con unidades de negocio. Por ejemplo, puedes tener grupos de entornos para tus equipos de pruebas, producción y desarrollo:

¿Estás listo para crear un grupo? Abrir Console

Para obtener más información sobre los entornos, sigue estos pasos: Sigue leyendo

Para obtener más información sobre los grupos de entornos, sigue estos pasos: Sigue leyendo

Enrutamiento y rutas base

En una configuración simple, una solicitud a un proxy de API implementada está compuesta por un nombre de host, una ruta base y un nombre de recurso de API. Por ejemplo:

https://www.example.com/shopping/cart/addItem
        |_____________| |___________| |_____|
               |             |           |
            hostname      basepath     resource

Define los nombres de host en el grupo de entorno para que varios entornos puedan compartirlos. Las rutas base y los recursos de la API se definen en el proxy de API.

Nota: Los nombres de entorno y grupo no afectan la URL del extremo de la API. Solo están destinadas para organizar y configurar tus entornos, y no están expuestos a los usuarios finales del proxy.

Para obtener más información sobre las rutas base y los recursos de API, comienza con Información sobre las rutas. Además, consulta la referencia de la configuración de flujo y la referencia de variables de flujo para comprender mejor cómo se relacionan estas piezas.

Nombres de host

Cuando creas un grupo de entornos, adjuntas uno o más nombres de host a ese grupo. Por ejemplo, puedes tener los siguientes grupos de entornos, cada uno con sus propios nombres de host:

Nombre del grupo de entornos (entornos)	prod-group (catalog-prod cart-prod pymnt-prod)	dev-group (dev-env)	test-group (test-env)
Nombres de host	catalog.example.com payment.example.com	dev.example.com	test.example.com

Debes definir rutas base en el proxy cuando las creas.

Cuando implementas un proxy en un entorno dentro del grupo, el nombre de host más la ruta base y el nombre del recurso definen en conjunto el extremo de una solicitud a la API de ese proxy.

Puedes definir más de un nombre de host en un grupo de entorno. Todos se pueden usar para llamar a cualquier proxy implementado en cualquier entorno del grupo. Por ejemplo, catalog.example.com/proxy1 y payment.example.com/proxy1 llamarán al recurso proxy1 si los nombres de host catalog.example.com y payment.example.com se definen en el mismo grupo de entorno.

Para admitir varios nombres de host en un solo grupo de entorno compartido por varios entornos, Apigee enruta las solicitudes a la API de diferentes proxies de maneras diferentes.

Ejemplo de enrutamiento

Por ejemplo:

• El grupo de entornos prod-group contiene los siguientes entornos:

  • catalog-prod
  • cart-prod
  • pymnt-prod

• prod-group tiene los siguientes nombres de host definidos:

  • catalog.example.com
  • payment.example.com

• Los siguientes proxies se implementan en estos entornos:

  • El proxy catalog en catalog-prod con una ruta base de /catalog
  • El proxy cart en cart-prod con una ruta base de /catalog/cart
  • El proxy payment en pymnt-prod con una ruta base de /payment

Esto crea los extremos siguientes:

• catalog.example.com/catalog enruta al proxy catalog en el entorno catalog-prod.
• catalog.example.com/catalog/cart enruta al proxy cart en el entorno cart-prod.
• payment.example.com/payment enruta al proxy payment en el entorno pymnt-prod.

En el siguiente ejemplo, se muestra que las solicitudes se enrutan a diferentes proxies que se implementan en entornos dentro del grupo, según el nombre de host y la ruta base:

Sugerencia:

Los nombres de host que defines en un grupo de entorno:

• Debe ser única en todos los grupos de entornos de una organización no pueden usarse en más de un grupo
• No admiten comodines
• Las rutas base deben ser únicas dentro de un host (no hay dos proxies que puedan tener la misma ruta base dentro de un host)

Para obtener más información, consulta cómo agregar nombres de host a un grupo.

Entornos compartidos y enrutamiento

Los entornos pueden pertenecer a varios grupos de entornos. Sin embargo, los nombres de host deben ser únicos para un solo grupo de entorno. Por lo tanto, pertenecer a varios grupos proporciona varias direcciones para los proxies implementados en ese entorno. Esto es útil si un cliente tiene certificados comodín (como *.example.com) para varios socios.

Por ejemplo:

• shared-env pertenece a dos grupos de entornos:
  • partner-1 con el alias de host api.partner-1.com
  • partner-2 con el alias de host api.partner-2.com
• El proxy foo se implementa en shared-env con una ruta base de /foo. Debido a que shared-env se comparte en ambos grupos de entornos, foo tiene dos direcciones:
  • partner-1.example.com/foo
  • partner-2.example.com/foo

En este caso, ambos nombres de host se enrutan al mismo entorno. Este es un caso en el que una empresa expone diferentes nombres de host para cada socio, y le proporciona a cada uno un nombre de dominio personalizado. Para Apigee Hybrid, esta situación puede usar mTLS con un certificado diferente para cada socio.

Acerca del alcance del entorno

La organización proporciona permisos para algunas capacidades de Apigee. Por ejemplo, los datos de mapa clave-valor (KVM) pueden estar disponibles a nivel de la organización, lo que significa que los proxies de API implementados en cualquier entorno de esa organización pueden acceder a los mismos datos de KVM.

Del mismo modo, algunas capacidades se pueden definir en entornos o grupos de entornos dentro de la organización. Por ejemplo, los datos de estadísticas de Apigee se particionan según una combinación de organización, entorno y grupo de entornos (finales).

Consideraciones

Cada implementación en un entorno tiene el potencial de afectar el enrutamiento del tráfico para cada grupo de entornos al que se adjuntó ese entorno. Cuando se agregan rutas de base nuevas, pueden comenzar a capturar tráfico completamente nuevo, o pueden comenzar a capturar un subconjunto de tráfico existente que ya esté administrado por una implementación existente.

Del mismo modo, cuando se quitan las rutas base, pueden corresponder a extremos que ya no reciben tráfico o pueden hacer que el tráfico existente se enrute a un proxy diferente. Cuando se redirecciona el tráfico, puede ser para algún proxy en el mismo entorno o cuando varios entornos comparten un solo grupo de entornos, puede ser de un proxy en un entorno diferente.

Recursos adicionales

En la información siguiente, se describe cómo administrar tus entornos y grupos de entornos:

• Con la IU de Apigee:

  • Trabaja con entornos
  • Trabaja con grupos de entornos

• Con la API de Apigee:

  • API de Environment
  • API de grupos de entorno
  • API de adjunto de grupo de entorno