Ciclo de vida del desarrollo de API

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 la API con Apigee.

Desarrollar proxies de API

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

Para obtener más información sobre los proxies de API, consulta Comprende las API y los proxies de API.

DesarrollO en la nube con Apigee

Desarrolla tus proxies de API con las herramientas de edición y depuración del proxy de API que se proporcionan con Apigee. Cuando 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 para implementar. Por lo general, implementas la revisión más reciente y, si es necesario, vuelves a una anterior. Consulta Implementa proxies de API.

Para comenzar a desarrollar tus proxies de API con Apigee, consulta Compila un proxy de API simple.

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 a través de pruebas de unidades y manuales (por ejemplo, enviar una solicitud y ver los resultados).

Después de completar la validación local, implementa la configuración del proxy de API como archivos en los entornos de Apigee. Consulta Implementa proxies de API.

Para comenzar a desarrollar tus proxies de API de forma local con Apigee en VS Code, consulta Compila tu primer proxy de API con Apigee en VS Code.

Implementa proxies de API

Crea entornos en los que se implementarán los proxies de API. La distinción entre los diferentes entornos es arbitraria: cada uno solo se identifica con un conjunto distinto de direcciones de red (URL). El objetivo es proporcionarte un dominio en el que puedas compilar y verificar los proxies de API antes de que la API se exponga a desarrolladores externos. Para obtener más información, consulta Información acerca de los entornos y grupos de entornos.

Si implementas tus API en varios entornos, puedes segregar el tráfico entre los proxies de API en los que trabajas en un entorno de prueba y aquellos a los que acceden las aplicaciones externas en el entorno de ejecución en un entorno de producción.

Apigee admite los siguientes tipos de implementación en un entorno:

Tipo Descripción
Proxy Desarrolla y prueba tus proxies de API en tus entornos de desarrollo de Apigee y, luego, impleméntalos en los entornos de producción y de prueba de integración de Apigee. Consulta Implementa un proxy de API.
Archive Desarrolla y prueba tus proxies de API programables con Apigee en VS Code.

Agrega políticas

Apigee te permite programar el comportamiento de la API con políticas sin escribir código. Una política es como un módulo que implementa una función de administración específica y limitada. Las políticas están diseñadas para que puedas agregar tipos comunes de funcionalidades de administración a una API de forma fácil y confiable. Las políticas proporcionan funciones como la seguridad, los límites de frecuencia, la transformación y la mediación, lo que evita que tengas que codificar y mantener esta funcionalidad por tu cuenta. También puedes escribir secuencias de comandos y códigos personalizados (como aplicaciones JavaScript), que extienden la funcionalidad del proxy de API y te permiten innovar con las capacidades de administración básicas compatibles con 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 destinadas a diversas funciones, como la administración del tráfico, la seguridad, la mediación y las políticas de extensiones. Para ver la lista completa de políticas disponibles en Apigee, consulta Descripción general de la referencia de políticas.

Asciende a producción

La elección de dónde implementar una API es tuya. Por ejemplo, puedes promover una revisión a un entorno de producción para permitir que los desarrolladores comiencen a trabajar con tu API. Al mismo tiempo, puedes iterar varias revisiones en un entorno local o de pruebas en el que agregas funciones o ajustes de políticas. Luego, cuando estés listo, puedes implementar la revisión nueva en el entorno de producción y reemplazar la revisión existente en ese entorno. Con este método, siempre puedes tener una revisión en vivo de tu API disponible para los desarrolladores mientras desarrollas y pruebas funciones nuevas.

Crea secuencias de comandos de implementación con la API de Apigee

Apigee proporciona una API de RESTful que te permite integrar la implementación y la administración del proxy de API en el ciclo de vida del desarrollo de software (SDLC) de tu organización. Por ejemplo, para garantizar que se cumplan los requisitos de seguridad, confiabilidad y coherencia, un uso común de la API de Apigee es escribir secuencias de comandos o códigos que implementen proxies de API de manera programática y promoverlos de un entorno a otro, como parte de un proceso automatizado más grande.

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

Administra los recursos de los entornos

Los entornos proporcionan segregación de datos y recursos. Por ejemplo, puedes configurar diferentes cachés en tus entornos test y production a los que solo pueden acceder los proxies de API que se ejecutan en ese entorno. Además, las claves de API que se emiten en un entorno de pruebas no son válidas en un entorno de producción y viceversa.

Para tener un control adicional durante la promoción, se recomienda que solo iteres a proxies de API en un entorno de prueba y realice la menor cantidad posible de cambios en los proxies de API implementados en un entorno de producción.

Para ello, debes asegurarte de que determinados recursos asociados con cada entorno estén configurados de tal manera que puedan permanecer estáticos en una configuración de proxy de API.

  • Mapas clave-valor (KVM): Si se aplican al entorno, debes asegurarte de que se usen convenciones de nombres para permitir que los proxies de API almacenen datos sin requerir cambios de configuración durante la promoción. Para obtener más información, consulta Usa mapas clave-valor.
  • URL de destino: es común que los proxies de API llamen a diferentes URL de backend durante las pruebas y la producción. Puedes usar las configuraciones de TargetServer para crear parámetros de configuración de TargetEndpoint independientes del entorno. Para obtener más información, consulte:
  • Objetivos de ServiceCallout: los textos de servicio pueden usar diferentes objetivos según el entorno, por ejemplo, si un ServiceCallout en el entorno de prueba consume un servicio de demostración. Consulta Política de ServiceCallout.

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