En este documento, se proporcionan instrucciones detalladas para configurar el conector de Apigee API Hub para Private Cloud y API Hub, lo que facilita la transferencia de metadatos de la API y estadísticas de tiempo de ejecución desde tu instalación de Apigee Edge para Private Cloud a API Hub de Google Cloud.
La integración de Apigee Edge para la nube privada y el Concentrador de APIs está diseñada para conectar tus entornos locales de Apigee con el Concentrador de APIs de Google Cloud. Esta integración permite el flujo continuo de metadatos críticos de la API (como definiciones de proxy de API, políticas, etcétera) y datos de análisis del tiempo de ejecución desde tus instalaciones de Apigee para Private Cloud directamente en el centro de APIs, lo que proporciona una vista centralizada y completa de tu panorama de APIs.
Descripción general
En esencia, esta integración permite que los usuarios de Apigee para Private Cloud incorporen la información de sus APIs en API Hub. Esto significa que puedes aprovechar las capacidades del Centro de APIs para el descubrimiento, la administración y la gestión centralizada de las APIs que se originan en tus implementaciones locales de Apigee.
Componentes clave
- Concentrador de la API (Google Cloud): Es la plataforma central basada en la nube en la que se consolidan y administran los metadatos y los datos de tiempo de ejecución de la API.
- Conector del centro de Apigee: Es un componente nuevo que se instala junto con tu entorno de Apigee Edge para la nube privada. Este conector es el agente principal responsable de extraer datos de Apigee Edge para la Nube Privada y publicarlos de forma segura en Google Cloud.
- Procesadores de mensajes (MPs): Son componentes existentes de Apigee que se reconfiguran para escribir datos de estadísticas de tiempo de ejecución de "escritura doble" en un sistema de archivos de red (NFS) compartido, lo que los pone a disposición del conector del centro de APIs de Apigee.
- Sistema de archivos de red (NFS): Es un volumen de almacenamiento compartido que se usa para almacenar temporalmente los datos de análisis de los MPs antes de que el conector del centro de APIs de Apigee los procese y suba.
- Google Cloud Pub/Sub: Es un servicio de mensajería que usa el conector de Apigee API Hub para Private Cloud para transmitir de forma segura metadatos de la API y datos del entorno de ejecución al centro de API.
- Cuentas de servicio de Google Cloud: Se usan para la autenticación y autorización seguras del conector de Apigee API Hub para Private Cloud para interactuar con los servicios de Pub/Sub y API Hub.
El flujo de integración
La integración sigue un proceso estructurado para garantizar la transferencia y la exactitud de los datos:
- Configuración y aprovisionamiento iniciales:
- Comienza por configurar un proyecto de Google Cloud y aprovisionar API Hub en él.
- Crea cuentas de servicio de Google Cloud y registra tus organizaciones de Apigee para Private Cloud en API Hub creando "instancias de complementos". En este paso, se proporcionan temas de Pub/Sub únicos y IDs de instancias de complementos esenciales para la configuración.
- Instalación del conector del centro de API de Apigee para Private Cloud:
- El conector de Apigee API hub para Private Cloud, un paquete RPM, se instala en una VM dedicada junto con tu entorno de Apigee for Private Cloud. Esto requiere una versión compatible de Apigee para la nube privada.
- Configuración del conector del concentrador de APIs de Apigee para Private Cloud:
- El conector se configura con los detalles obtenidos durante la creación del complemento de API Hub (temas de Pub/Sub, IDs de instancias de complementos y detalles de la cuenta de servicio).
- Se establece la autenticación en los servicios de Google Cloud (a través de claves de cuentas de servicio) y en el servidor de administración de Apigee (a través de credenciales codificadas en base64).
- Aquí también se configura la ruta al NFS compartido.
- Configuración del procesador de mensajes (MP):
- Se actualizaron los procesadores de mensajes de Apigee para habilitar un mecanismo de "escritura doble" para los datos de Analytics. Esto significa que los registros de Analytics se escriben tanto en el sistema de Analytics tradicional como en el recurso compartido de NFS designado.
- Flujo de datos:
- Metadatos de la API: El centro de APIs de Apigee para el conector de Private Cloud extrae los metadatos de la API del servidor de administración de Apigee y los publica en el tema de Pub/Sub de metadatos designado en Google Cloud, que luego se incorpora al centro de APIs.
- Datos de tiempo de ejecución: Los procesadores de mensajes escriben datos de análisis en el NFS compartido. El conector del centro de Apigee supervisa este NFS, procesa los datos del entorno de ejecución y los publica en el tema de Pub/Sub de datos del entorno de ejecución designado en Google Cloud para su transferencia a API Hub.
- Supervisión y solución de problemas:
- Un extremo de estado local en el centro de APIs de Apigee para el conector de Private Cloud te permite supervisar el progreso de las cargas de metadatos y datos del entorno de ejecución.
- Hay registros detallados disponibles para solucionar cualquier problema relacionado con el inicio, la transferencia de datos o la conectividad.
Interdependencias:
- El conector de Apigee API Hub para Nube Privada depende de que el NFS esté correctamente montado y sea accesible tanto para sí mismo como para todos los procesadores de mensajes.
- Los procesadores de mensajes deben configurarse para la escritura dual en el NFS para habilitar la recopilación de datos en el tiempo de ejecución.
- Los roles correctos de la cuenta de servicio de Google Cloud y los detalles de la instancia del complemento de API Hub son fundamentales para las capacidades de autenticación y publicación de datos del conector.
Esta integración proporciona un mecanismo sólido para incorporar tus APIs de Apigee locales a la administración y visibilidad centralizadas que proporciona API Hub, lo que permite mejorar la administración y las estadísticas de las APIs.