Descripción general de implementación

Estás viendo la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Más 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 API.

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

Cuándo implementar un proxy

Se debe implementar un proxy para poder invocarlo. En general, depende de ti durante la implementación. Cuando trabajas en un entorno de pruebas, puedes realizar implementaciones 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 cuando hagas lo siguiente:

  • Crea un proxy nuevo (la implementación se realiza de forma automática)
  • 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 un almacén de claves y vuelve a crearlo.

Dónde implementar un proxy

Debes implementar un proxy en un entorno. De forma predeterminada, todas las organizaciones de Apigee Edge tienen dos entornos llamados prueba y prod, que se diseñaron simplemente con el fin de proporcionarte un área para trabajar y probar los cambios de API, y otra área en la que las APIs están expuestas 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 del lugar en el que lo desarrollas. Si estás trabajando en la IU, puedes implementar fácilmente un proxy con solo algunos clics del mouse. Un proxy nuevo se implementa de forma automática cuando lo creas; no tienes que realizar ninguna acción 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, si trabajas con archivos XML de 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 también implementar tus archivos 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 API a medida que las creas y 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és listo, puedes "promover" la revisión superior de tu proxy de API desde el entorno test por sobre la revisión anterior del proxy de API en el entorno prod.

Para obtener más información sobre las revisiones, consulta Implementar proxies de API mediante la API de Management e Implementar proxies en la IU.

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