Ciclo de vida del desarrollo de las APIs

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

En las siguientes secciones se resume el ciclo de vida del desarrollo de APIs con Apigee.

Desarrollar proxies de API

Apigee admite las siguientes opciones para el desarrollo iterativo de proxies de API:

Para obtener más información sobre los proxies de API, consulta el artículo Comprender las APIs y los proxies de APIs.

Desarrollo en la nube con Apigee

Desarrolla tus proxies de API con las herramientas de edición y depuración de proxies de API que proporciona Apigee. Mientras trabajas en un proxy de API, Apigee guarda las iteraciones de tu configuración como revisiones.

Cuando implementas un proxy de API, eliges una revisión específica. Normalmente, se implementa la revisión más reciente y, si es necesario, se vuelve a una revisión anterior. Consulta Desplegar proxies de API.

Para empezar a desarrollar tus proxies de APIs con Apigee, consulta el artículo Desarrollar un proxy de APIs sencillo.

Desarrollo local con Apigee en VS Code

Usa Apigee en Visual Studio Code (VS Code) para desarrollar tus proxies de API y verificar la funcionalidad mediante pruebas unitarias y manuales (por ejemplo, envía una solicitud y consulta los resultados).

Una vez que hayas completado la validación local, implementa las configuraciones de tu proxy de API como archivos en tus entornos de Apigee. Consulta Desplegar proxies de API.

Para empezar a desarrollar tus proxies de API de forma local con Apigee en VS Code, consulta el artículo Crear tu primer proxy de API con Apigee en VS Code.

Desplegar proxies de APIs

Crea entornos en los que desplegar proxies de APIs. La distinción entre los diferentes entornos es arbitraria: cada entorno se identifica simplemente mediante un conjunto diferente de direcciones de red (URLs). El objetivo es proporcionarte un dominio en el que puedas crear y verificar proxies de API antes de que la API se exponga a desarrolladores externos. Para obtener más información, consulta Acerca de los entornos y los grupos de entornos.

Al desplegar tus APIs en varios entornos, puedes separar el tráfico entre los proxies de API en los que estés trabajando en un entorno de prueba y los que estén accediendo a aplicaciones externas en tiempo de ejecución en un entorno de producción.

Apigee admite los siguientes tipos de implementaciones en un entorno:

Tipo Descripción
Proxy Desarrolla y prueba tus proxies de API en tus entornos de desarrollo de Apigee y, a continuación, despliégalos en los entornos de prueba de integración y producción de Apigee. Consulta Desplegar un proxy de APIs.
Archivar Desarrolla y prueba tus proxies de API programables con Apigee en VS Code.

Añadir políticas

Apigee te permite programar el comportamiento de las APIs sin tener que escribir código mediante el uso de políticas. Una política es como un módulo que implementa una función de gestión específica y limitada. Las políticas se han diseñado para que puedas añadir tipos comunes de funciones de gestión a una API de forma fácil y fiable. Las políticas proporcionan funciones como seguridad, limitación de frecuencia, transformación y mediación, lo que te ahorra tener que codificar y mantener estas funciones por tu cuenta. También puedes escribir secuencias de comandos y código personalizados (como aplicaciones JavaScript) que amplíen las funciones del proxy de API y te permitan innovar a partir de las funciones de gestión básicas que admiten las políticas de Apigee. Para obtener más información sobre las políticas de Apigee, consulta ¿Qué es una política?

Apigee proporciona políticas listas para usar en varias funciones, como la gestión del tráfico, la seguridad, la mediación y las políticas de extensión. Para ver la lista completa de políticas disponibles en Apigee, consulta el resumen de la referencia de políticas.

Pasar a producción

Tú eliges dónde implementar una API. Por ejemplo, puedes promocionar una revisión a un entorno de producción para que los desarrolladores empiecen a trabajar con tu API. Al mismo tiempo, puedes estar iterando varias revisiones en un entorno local o de prueba, donde añades funciones o ajustas políticas. Después, cuando lo tengas todo listo, podrás desplegar la nueva revisión en el entorno de producción, lo que sobrescribirá la revisión que ya haya en ese entorno. Con este método, siempre puedes tener una revisión activa de tu API disponible para los desarrolladores mientras desarrollas y pruebas nuevas funciones.

Crear scripts de despliegue con la API de Apigee

Apigee proporciona una API RESTful que te permite integrar la implementación y la gestión de proxies de API en el ciclo de vida de desarrollo de software (SDLC) de tu organización. Por ejemplo, para asegurarse de que se cumplen los requisitos de seguridad, fiabilidad y coherencia, un uso habitual de la API de Apigee es escribir secuencias de comandos o código que implementen proxies de API de forma programática y los promuevan de un entorno a otro como parte de un proceso automatizado más amplio.

Para obtener más información, consulta la API de Apigee.

Gestionar recursos del entorno

Los entornos permiten segregar los datos y los recursos. Por ejemplo, puedes configurar diferentes cachés en tus entornos test y production a los que solo puedan acceder los proxies de API que se ejecuten en ese entorno. Además, las claves de API emitidas en un entorno de prueba no son válidas en un entorno de producción, y viceversa.

Para tener más control durante la promoción, te recomendamos que solo hagas cambios en los proxies de API en un entorno de prueba y que hagas los mínimos cambios necesarios en los proxies de API desplegados en un entorno de producción.

Para ello, debe asegurarse de que determinados recursos asociados a cada entorno estén configurados de forma que puedan permanecer estáticos en una configuración de proxy de API.

  • Mapas de pares clave-valor (KVMs): si se limitan al entorno, debes asegurarte de que se usen convenciones de nomenclatura para que los proxies de API puedan almacenar datos sin necesidad de cambiar la configuración durante la promoción. Para obtener más información, consulta Usar mapas de clave-valor.
  • URLs de destino: es habitual que los proxies de API llamen a diferentes URLs de backend durante las pruebas y la producción. Puede usar configuraciones de TargetServer para crear configuraciones de TargetEndpoint independientes del entorno. Para obtener más información, consulta
  • Destinos de ServiceCallout: los ServiceCallout pueden usar diferentes destinos en función del entorno. Por ejemplo, un ServiceCallout en el entorno de prueba puede consumir un servicio de demostración. Consulta la política ServiceCallout.

Para que las configuraciones de proxy de API sean independientes del entorno, también puedes usar instrucciones condicionales. Las instrucciones condicionales creadas con la variable environment.name se pueden usar para evaluar el entorno actual antes de aplicar una política o de enrutar a una URL en el backend. Para obtener más información, consulta Condiciones con variables de flujo.