Edge para la nube privada v4.18.01
Novedades
Consulta 4.18.01: Notas de la versión de Edge para la nube privada.
Accede a la comunidad de Apigee
La comunidad de Apigee es un recurso gratuito con el que puedes comunicarte con Apigee y otros clientes de Apigee si tienes preguntas, sugerencias y otros problemas. Antes de publicar en la comunidad, asegúrate de buscar primero las publicaciones existentes para ver si ya se respondió tu pregunta.
Descripción general de la arquitectura
Antes de instalar Apigee Edge para la nube privada, debes estar familiarizado con la organización general de los módulos y componentes de software de Edge.
Apigee Edge para la nube privada consta de los siguientes módulos:
- Puerta de enlace de Apigee Edge (también conocida como servicios de API)
- Análisis de Apigee Edge
- BaaS de la API de Apigee
- Canal para desarrolladores de Apigee Edge
- Servicios de monetización de Apigee Edge (también conocidos como Monetización de servicios para desarrolladores)
Nota: El canal de desarrollador de Apigee Edge no está disponible para que lo instale el instalador de Edge para nube privada. El canal de desarrollador está disponible para la instalación local mediante una secuencia de comandos independiente. Si quieres instalar Developer Channel, comunícate con el equipo de Asistencia de Apigee Edge.
Puerta de enlace de Apigee Edge
Edge Gateway es el módulo principal de Apigee Edge y es la herramienta principal para administrar tus APIs. La IU de Gateway proporciona herramientas para agregar y configurar APIs, configurar paquetes de recursos y administrar desarrolladores y apps. Gateway transfiere muchos problemas de administración comunes de tu API de backend. Cuando agregas una API, puedes aplicar políticas de seguridad, límite de frecuencia, mediación, almacenamiento en caché y otros controles. También puedes personalizar el comportamiento de tu API mediante la aplicación de secuencias de comandos personalizadas, la realización de llamadas a API de terceros, etc.
Componentes de software
Edge Gateway se compila a partir de los siguientes componentes principales:
- Servidor de administración perimetral
- Apache ZooKeeper
- Apache Cassandra
- Router perimetral
- Procesador de mensajes perimetrales
- OpenLDAP
- IU de Edge
La puerta de enlace perimetral está diseñada para que se puedan instalar en un solo host o distribuirse entre varios hosts.
Análisis de Apigee Edge
Edge Analytics cuenta con potentes estadísticas de APIs para observar las tendencias de uso a largo plazo. Puedes segmentar tu público según los desarrolladores y las apps más importantes, conocer el uso según el método de la API para saber dónde invertir y crear informes personalizados con información a nivel de la empresa.
A medida que los datos pasan por Apigee Edge, se recopilan varios tipos predeterminados de información, que incluyen la URL, la IP, el ID del usuario de la información de las llamadas a la API, la latencia y los datos de errores. Puedes usar políticas para agregar otro tipo de información, como encabezados, parámetros de consulta y partes de una solicitud o respuesta extraídas de XML o JSON.
Todos los datos se envían a Edge Analytics, donde el servidor de estadísticas los mantiene en segundo plano. Las herramientas de agregación de datos se pueden usar para compilar varios informes integrados o personalizados.
Componentes de software
Edge Analytics incluye lo siguiente:
- Qpid, que consta de lo siguiente:
- Sistema de mensajería Apache Qpid
- Servicio de servidor Qpid de Apigee: un servicio de Java de Apigee que se usa para administrar Apache Qpid
- Postgres, que consta de lo siguiente:
- Base de datos de PostgreSQL
- Servicio del servidor de Postgres de Apigee: un servicio de Java de Apigee que se usa para administrar la base de datos de PostgreSQL
BaaS de la API de Apigee
La BaaS de la API es un backend como servicio (BaaS) completo para impulsar las apps web y para dispositivos móviles que puedes instalar como complemento de Edge. La BaaS de la API brinda a los desarrolladores de apps acceso a un almacén de datos flexible y funciones diferenciadoras clave, como gráficos sociales, ubicación geográfica, administración de usuarios, notificaciones push, supervisión del rendimiento y mucho más. La BaaS de la API pone estas funciones a disposición de los SDK para iOS, Android, JavaScript y otros, lo que permite que los desarrolladores de apps se enfoquen en crear las funciones enriquecidas y la experiencia del usuario que realmente diferencian a una app cliente en lugar de perder tiempo implementando infraestructura y servicios de backend principales.
Funciones de la BaaS de la API
El sitio de documentación de Apigee contiene información detallada sobre las funciones de la BaaS de API. Consulta http://apigee.com/docs/app-services/content/app-services-features.
En el siguiente diagrama, se ilustra cómo interactúan los componentes de la BaaS de la API.
Componentes de software
La BaaS de API se compila a partir de los siguientes componentes principales:
- Pila de API de BaaS: implementada en el servidor web de Tomcat
- Portal de BaaS de la API: IU implementada en el servidor web Nginx
- ElasticSearch: Motor de búsqueda distribuido en el texto completo. ElasticSearch se puede instalar en el mismo nodo que la API de BaaS Stack o en su propio nodo.
Puedes escalar horizontalmente la capacidad de la API de REST de BaaS si agregas servidores Tomcat y usas un balanceador de cargas para enrutar las solicitudes web a todos los servidores activos.
Para obtener más información sobre cómo comenzar a usar API BaaS, consulta http://apigee.com/docs/content/build-apps-home.
Canal para desarrolladores de Apigee Edge
El canal de desarrolladores de Edge es un portal de plantillas para la administración de la comunidad y el contenido. Se basa en el proyecto de código abierto de Drupal (http://www.drupal.org). La configuración predeterminada permite crear y administrar documentación, foros y blogs de API. Una consola de pruebas integrada permite probar las APIs en tiempo real desde el portal.
Además de la administración de contenido, el Canal para desarrolladores tiene varias funciones para la administración de la comunidad, como el registro manual o automático de usuarios y la moderación de comentarios. El modelo de control de acceso basado en roles (RBAC) controla el acceso a los atributos en el canal de desarrollador. Por ejemplo, puedes habilitar controles para permitir que un usuario registrado cree publicaciones en el foro, use consolas de prueba, etcétera.
La secuencia de comandos de implementación de Apigee Edge para nube privada no incluye la implementación del canal de desarrollador. La implementación local del canal del desarrollador es compatible con su propia secuencia de comandos de instalación. Si quieres instalar y configurar el canal del desarrollador, comunícate con el equipo de asistencia de Apigee.
Servicios de monetización de Apigee Edge
Los servicios de monetización perimetral son una nueva extensión eficaz de Apigee Edge para la nube privada. Como proveedor de APIs, necesitas una forma fácil de usar y flexible para monetizar tus APIs de modo que puedas generar ingresos por su uso. Los Servicios de Monetización resuelven esos requisitos. Con los servicios de monetización, puedes crear una variedad de planes de tarifas que les cobran a los desarrolladores por el uso de tus APIs agrupadas en paquetes. La solución ofrece un amplio grado de flexibilidad: puedes crear planes prepagados, pospagos, planes de tarifas fijas, planes de tarifas variables, planes “freemium”, planes personalizados para desarrolladores específicos, planes que abarquen a grupos de desarrolladores y mucho más.
Además, los Servicios de Monetización incluyen las instalaciones de informes y facturación. Por ejemplo, como proveedor de API, puedes obtener informes detallados o resumidos sobre el tráfico de tus paquetes de API para los desarrolladores que compraron un plan de tarifas. También puedes realizar ajustes en estos registros según sea necesario. Además, puedes crear documentos de facturación (que incluyan los impuestos aplicables) para el uso de tus paquetes de API y publicarlos para los desarrolladores.
También puedes establecer límites que te permitan controlar y supervisar el rendimiento de tus paquetes de API, lo que te permitirá reaccionar según corresponda y configurar notificaciones automáticas para cuando se acerquen o alcancen esos límites.
Nota: El requisito principal de Apigee Edge (Gateway y Analytics) es un requisito para usar los servicios de monetización.
Funciones de los servicios de monetización
Las funciones clave de los servicios de monetización perimetral incluyen las siguientes:
- Completamente integrada en la plataforma de API significa una interacción en tiempo real
- Admite todos los modelos de negocios listos para usar, desde planes simples basados en tarifas hasta los planes de cobro o reparto de ingresos más complejos (planes fáciles de crear y modificar).
- Califique las transacciones según el volumen o los “atributos personalizados” de cada transacción. La transacción puede estar compuesta por APIs de otros sistemas de Gateway PLUS (externos a Apigee Edge)
- Herramientas automatizadas, como límites y notificaciones, para supervisar el rendimiento y administrar el proceso
- Flujo de trabajo y controles integrados de desarrolladores y socios para administrar las compras mediante la facturación y el pago
- Ofrece autoservicio completamente para usuarios empresariales y desarrolladores o socios, por lo que no es necesario intervenir técnicamente costosa.
- Integrado en cualquier sistema backend de ventas, contabilidad y ERP
Componentes de software
Los servicios de monetización perimetral se basan en los siguientes componentes principales:
- Servidor de administración perimetral
- Procesador de mensajes perimetrales
Para obtener más información sobre cómo comenzar a usar los servicios de monetización mediante la IU de Edge, consulte http://apigee.com/docs/monetization-services/content/get-started-using-monetization-services.
Implementación local
Una instalación local de Apigee Edge para la nube privada (Gateway y Analytics) principal proporciona la infraestructura necesaria para ejecutar el tráfico de API en nombre de los clientes locales.
Los componentes que proporciona la instalación local de Edge Gateway incluyen (entre otros):
- Un router controla todo el tráfico de API entrante desde un balanceador de cargas, determina la organización y los entornos para el proxy de API que controla la solicitud, balancea las solicitudes entre los procesadores de mensajes disponibles y, luego, despacha la solicitud. El router finaliza la solicitud HTTP, controla el tráfico TLS/SSL y usa el nombre del host virtual, el puerto y el URI para dirigir las solicitudes al procesador de mensajes adecuado.
- Un procesador de mensajes procesa las solicitudes a la API. Message Processor evalúa una solicitud entrante, ejecuta todas las políticas de Apigee y llama a los sistemas de backend y a otros sistemas para recuperar datos. Una vez que se reciben esas respuestas, Message Processor formatea una respuesta y la muestra al cliente.
- Apache Cassandra es el repositorio de datos del entorno de ejecución que almacena la configuración de las aplicaciones, los contadores de cuotas distribuidos, las claves de API y los tokens de OAuth para las aplicaciones que se ejecutan en la puerta de enlace.
- Un Apache ZooKeeper contiene datos de configuración sobre la ubicación y la configuración de los distintos componentes de Apigee, y notifica a los diferentes servidores sobre los cambios en la configuración.
- Un OpenLDAP (LDAP) para administrar usuarios y funciones del sistema y la organización.
- Un servidor de administración para contener estos componentes. El servidor de administración es el extremo para las solicitudes a la API de Edge Management. También interactúa con la IU de Edge.
- La IU proporciona herramientas basadas en el navegador que te permiten realizar la mayoría de las tareas necesarias para crear, configurar y administrar proxies de API, productos de API, apps y usuarios.
Entre los componentes que proporciona la instalación local de Edge Analytics, se incluyen los siguientes:
- Un servidor Qpid administra el sistema de colas para datos de estadísticas.
- Un servidor de Postgres administra la base de datos de estadísticas de PostgreSQL.
En el siguiente diagrama, se ilustra cómo interactúan los componentes de Apigee Edge:
