Descripción general de implementación

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

En este tema, se proporciona una descripción general rápida de la implementación del proxy. Puedes implementar proxies mediante la IU de administración, las secuencias de comandos de la línea de comandos o las APIs.

Video: Mira un video breve a fin de obtener información sobre las prácticas recomendadas para evitar tiempo de inactividad durante la implementación del proxy de API.

Cuándo implementar un proxy

Se debe implementar un proxy para poder invocarlo. En general, depende de ti cuando realizas la implementación. Cuando trabajas en un entorno de pruebas, puedes implementar de forma iterativa muchas veces. Por otro lado, la decisión de implementar un proxy del entorno de pruebas a un entorno de producción suele depender de las reglas del ciclo de vida que estableció tu equipo de desarrollo.

Implementa o vuelve a implementar un proxy en las siguientes situaciones:

  • Crea un proxy nuevo (la implementación se realiza automáticamente)
  • Modifica un proxy existente
  • Crea una revisión nueva de un proxy
  • Crea una versión nueva de un proxy
  • Envía un proxy de un entorno a otro, por ejemplo, de un entorno de pruebas a uno de producción.
  • Borra y vuelve a crear un almacén de claves.

Dónde implementar un proxy

Se implementa un proxy en un entorno. De forma predeterminada, todas las organizaciones de Apigee Edge tienen dos entornos llamados test y prod que se diseñaron simplemente para proporcionarte un área en la que trabajar y probar los cambios en la API, y otra en la que las APIs se exponen a las apps. En la siguiente figura, se muestra un proxy que se implementa en el entorno test, como lo indica el punto verde.

Cómo implementar un proxy

La forma de implementar un proxy depende de dónde lo desarrollas. Si estás trabajando en la IU, puedes implementar un proxy de manera sencilla con solo unos clics. Un proxy nuevo se implementa de forma automática cuando lo creas; no tienes que hacer nada especial. El procedimiento para volver a implementar un proxy existente es casi igual de simple. Solo debes seleccionar el entorno de implementación, y la IU de administración se encargará del resto. Para obtener más información, consulta Implementa proxies en la IU.

Si desarrollas proxies y componentes relacionados sin conexión (es decir, trabajas con archivos XML del proxy y otros códigos directamente en tu sistema de archivos), Apigee Edge proporciona una herramienta de implementación de línea de comandos conveniente que puedes usar. También puedes obtener una secuencia de comandos de shell de muestra que puedes configurar y ejecutar para subir y, luego, implementar tus archivos de proxy. Para obtener más información, consulta Implementa proxies desde la línea de comandos.

Por último, puedes usar la API de Edge Management para implementar proxies. Las APIs de implementación exponen funciones atómicas que tu equipo de desarrollo puede coordinar para automatizar y optimizar el ciclo de vida de desarrollo de tu API. Consulta Implementa proxies de API con la API de Management.

¿Qué es una revisión de proxy de API?

Las revisiones te permiten administrar las actualizaciones del proxy de la API a medida que las creas y, luego, las implementas en un entorno. Las revisiones están numeradas de forma secuencial, lo que te permite revertir un cambio mediante la implementación de una revisión anterior de tu proxy de API.

Solo se puede implementar una revisión de un proxy de API en un entorno a la vez si las revisiones comparten la misma ruta base del proxy de API.

Por lo general, se debe anular la implementación de una revisión existente antes de implementar una nueva. Otras opciones avanzadas incluyen reemplazar una revisión implementada o optar por no aumentar una revisión en absoluto. Por ejemplo, a veces, cuando realizas cambios menores, es posible que no desees aumentar la revisión. Estas opciones avanzadas se pueden lograr a través de llamadas directas a la API de Edge Management. Consulta Implementa proxies de API con la API de Management.

Puedes implementar una revisión de un proxy de API en el entorno prod y seguir creando revisiones nuevas de ese proxy de API en el entorno test. Cuando esté todo listo, puedes “promover” la revisión superior de tu proxy de API desde el entorno test sobre la revisión anterior del proxy de API en el entorno prod.

Para obtener más información sobre las revisiones, consulta Implementa proxies de API mediante la API de Management y, también, Implementa proxies en la IU.

Video: Mira un breve video para obtener más información sobre las revisiones de la API.