Descripción general de implementación

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

Consulta la documentación de Apigee Edge.

Nota: A fin de implementar proxies de API en entornos habilitados para implementaciones de archivos, consulta Implementa y administra archivos en un entorno de Apigee.

Cuando realizas un cambio en un proxy de API, puedes guardarlo como una revisión nueva y, luego, implementarlo en tu clúster.

Guía de inicio rápido:

• Implementa un proxy de API
• Anula la implementación de un proxy de API

Acerca de la implementación

En la siguiente figura, se muestra el ciclo de vida de la implementación de una revisión del proxy de API en Apigee.

Nota: En Apigee, los MP actúan de forma independiente entre sí, y cualquier MP puede estar en un estado diferente al de los otros MP (como activos o inhabilitados). Esto se conoce como un modelo de implementación de coherencia eventual para los proxies de API.

Limitaciones de las revisiones del proxy de API

Las siguientes limitaciones se aplican a las revisiones del proxy de API:

• Si realizas algún cambio en un proxy de API, debes implementarlo como una revisión nueva.
• Después de implementar un proxy de API, la revisión es de solo lectura. No puedes cambiar una revisión del proxy de API (por ejemplo, para realizar cambios incrementales). La única forma de cambiar una revisión es crear una revisión nueva y, luego, implementarla.
• Los MP pueden implementar un paquete de proxy solo en su totalidad. Si realizas cambios en políticas o fragmentos individuales, los MP seguirán implementando todo el paquete de proxy.
• Si tu uso de Apigee distingue entre proxies estándar y extensibles, cuando se implementa una revisión que cambia un proxy de API de un proxy estándar a un proxy extensible, ocurre lo siguiente:
  • es posible que se genere un costo. Si eres un cliente de pago por uso, consulta los derechos de pago por uso. Si eres cliente de una suscripción, consulta los detalles de tu plan.
  • la implementación requiere tiempo adicional. Durante la ventana de implementación, el flujo de llamadas a la API no se interrumpe, pero no puedes implementar, anular la implementación ni borrar el proxy. Además, las revisiones actuales o nuevas no se pueden borrar durante el período de implementación. Se permiten los cambios en el proxy de API y la creación de revisiones nuevas.

Implementación sin tiempo de inactividad

Todas las implementaciones correctas de proxy de API en Apigee son implementaciones sin tiempo de inactividad. Las implementaciones del proxy de API ocurren en este orden:

1. Se implementa la revisión 1 del proxy de API /hello y controla el tráfico.
2. Se implementa la revisión 2 de /hello.
3. La revisión 2 se implementa en los Message Processors en el plano del entorno de ejecución.
4. Se anula la implementación de la revisión 1.

La implementación de la revisión del proxy de API ahora está completa sin tiempo de inactividad.

Nota: Si la implementación de la revisión 2 falla por algún motivo, la implementación de versión anterior, revisión 1, sigue anulada. En este caso, puedes volver a implementar la revisión anterior para restablecerla. Luego, puedes corregir la nueva revisión e implementarla.

Visualiza el estado de implementación

Implementar un proxy de API en Apigee no hace que esté disponible de inmediato. El proxy de API demora en sincronizarse en todos los MP del plano de entorno de ejecución. Sin embargo, Apigee proporciona herramientas que pueden darte información sobre el estado de las revisiones del proxy de API.

IU clásica de Apigee

Dentro de la IU de Apigee, hay varias vistas que proporcionan el estado de implementación de los proxies de API.

Vista de la IU de Apigee

Pasos y descripción

Proxies

Selecciona Desarrollar > Proxies de API. La IU de Apigee usa los siguientes íconos a fin de proporcionar un estado rápido para cada proxy de API: Indica que el proxy de API no se implementó en el entorno seleccionado. Indica que no hay errores ni advertencias para ese proxy en el entorno seleccionado. Indica que no se actualizó parte del enrutamiento debido a conflictos con las rutas base. Indica que se produjo un error cuando se implementó el proxy de API. Para ver el ícono de estado, haz clic en la pestaña Desarrollar. Como alternativa, puede seleccionar Desarrollar > Proxies de API y hacer clic en un proxy de API.

API de Apigee

Para ver el estado de implementación de tu revisión del proxy de API en un entorno, usa la siguiente llamada a la API:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/deployments" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

En el ejemplo anterior, $TOKEN está configurado como tu token de acceso de OAuth 2.0, como se describe en Obtén un token de acceso de OAuth 2.0. Para obtener información sobre las opciones de curl que se usan en este ejemplo, consulta Usa curl. Si deseas obtener una descripción de las variables de entorno que se usaron, consulta Configura variables de entorno para solicitudes a la API de Apigee.

A continuación, se proporciona un ejemplo de la respuesta. En este ejemplo, se muestra el estado de implementación para la revisión 1 del proxy de API de helloworld que se implementa en el entorno test:

{
  "environment": "test",
  "apiProxy": "helloworld",
  "revision": "1",
  "deployStartTime": "1559149080457",
  "pods": [
    {
      "podName": "apigee-runtime-myorg-test-f8bdf9d-2s72w",
      "deploymentStatus": "deployed",
      "statusCodeDetails": "Deployment Success",
      "podStatus": "active",
      "podStatusTime": "1595357668001"
    }
  ],
  "state": "READY"
}

Para obtener más información, consulta la API de implementaciones del entorno de revisión del proxy de API.

gcloud

Para ver el estado de implementación de la revisión del proxy de API en un entorno, usa el siguiente comando de gcloud:

gcloud alpha apigee deployments describe --api=$API --environment=$ENV

Para obtener más información y una descripción de las variables de entorno utilizadas en los ejemplos, consulta Comienza a usar gcloud con Apigee.

A continuación, se proporciona un ejemplo de la respuesta. En este ejemplo, se muestra el estado de implementación para la revisión 1 del proxy de API de helloworld que se implementa en el entorno test:

Using Apigee organization `my-org`
Using deployed revision `1`
apiProxy: helloworld
deployStartTime: '1598032332802'
environment: test
pods:
- deploymentStatus: deployed
  podName: apigee-runtime-myorg-test-f8bdf9d-2s72w
  podStatus: active
  podStatusTime: '1598302128087'
  statusCodeDetails: Deployment Success
revision: '1'
state: READY

Para obtener más información, consulta Describe la CLI de implementaciones.

Consulta el uso de la implementación de proxy

El uso de proxies de API en tu organización puede estar sujeto a una cuota de implementaciones, que es un límite para la cantidad de unidades de implementación que puedes usar a la vez. Consulta tus derechos (Pago por uso o Suscripción) para obtener más detalles. Puedes ver el uso de la implementación de proxy de tu organización desde varios lugares de la IU de Apigee en la consola de Cloud, como se describe a continuación.

Nota: Si tu organización está habilitada para Apigee Hybrid, solo se muestra un subconjunto de estas métricas de uso.

Consulta el uso de la implementación en la página Descripción general de Apigee

Para ver el uso de la implementación de tu proxy de API en la página Descripción general de Apigee, sigue estos pasos:

1. Abre la página Resumen en la IU de Apigee en la consola de Google Cloud.

   Ir a Descripción general

2. Puedes ver el uso de la implementación de proxy de tu organización de un vistazo con la tarjeta Uso de proxy, que muestra la siguiente información de tu organización:
   • Total de proxies creados: Es la cantidad total de proxies de API creados, incluidos los implementados y los que no se implementaron.
   • Proxies implementados: Es la cantidad total de proxies de API implementados en todos los entornos de la organización.
   • Unidades de implementación de proxies: Es la cantidad total de revisiones de proxy de API o de flujo compartido que se implementaron en tu organización. Cada implementación por entorno y por instancia se cuenta como una unidad.
   • Proxies y flujos compartidos implementados en función del límite: Es la cantidad total de proxies de API y flujos compartidos implementados en la organización en función del límite de tu tipo de organización.
   • Unidades de implementación extensibles: Es la cantidad de revisiones de proxy de API extensibles implementadas en tu organización. Cada implementación por entorno y por instancia se cuenta como una unidad.
   • Unidades de implementación estándar: Es la cantidad de revisiones de proxy de API estándar implementadas en tu organización. Cada implementación por entorno y por instancia se cuenta como una unidad.

Consulta el uso de la implementación en la página Proxy de API

Para ver el uso de la implementación de tu proxy de API en la página Proxies de API, sigue estos pasos:

1. Abre la página Proxys de API en la IU de Apigee en la consola de Google Cloud.

   Ir a los proxies de API

2. La página Proxys de API muestra la siguiente información:
   • Total de proxies creados: Es la cantidad total de proxies de API desarrollados en tu organización, incluidos los proxies implementados y no implementados.
   • Proxies implementados: Es la cantidad total de revisiones de proxy de API implementadas en todos los entornos de tu organización.
   • Unidades de implementación de proxy: Es la cantidad total de revisiones de proxy de API o de flujos compartidos implementadas en todos los entornos de tu organización. Cada implementación por entorno y por instancia se cuenta como una unidad.
   • Unidades de implementación de proxy extensibles: Es la cantidad de revisiones de proxy de API extensibles implementadas en todos los entornos de tu organización. Cada implementación por entorno y por instancia se cuenta como una unidad.
   • Unidades de implementación de proxy estándar: Es la cantidad de revisiones de proxy de API estándar implementadas en todos los entornos de tu organización. Cada implementación por entorno y por instancia se cuenta como una unidad.

Consulta el uso de la implementación en la página Entornos

Para ver el uso de la implementación de proxy de API en la página Entornos, sigue estos pasos:

1. Abre la página Entornos en la IU de Apigee en la consola de Google Cloud.

   Ir a Entornos

2. Selecciona la pestaña de descripción general Entornos para mostrar la siguiente información de todos los entornos:
   • Total de unidades de implementación de proxy: Es la cantidad total de revisiones de proxy de API o de flujos compartidos implementadas en todos los entornos de tu organización.
   • Unidades de implementación de proxy extensibles: Es la cantidad de revisiones de proxy de API extensibles implementadas en todos los entornos de tu organización. Cada implementación por entorno y por instancia se cuenta como una unidad.
   • Unidades de implementación de proxy estándar: Es la cantidad de revisiones de proxy de API estándar implementadas en todos los entornos de tu organización. Cada implementación por entorno y por instancia se cuenta como una unidad.
   • Unidades de implementación de flujo compartido: Es la cantidad total de revisiones de flujo compartido implementadas en todos los entornos de tu organización. Cada implementación por entorno y por instancia se cuenta como una unidad.
3. Para ver el uso de la implementación de proxy de un solo entorno, haz lo siguiente:
   1. En la lista Entornos, selecciona el nombre de un entorno para ver sus detalles.
   2. Selecciona la pestaña Implementaciones para ver el uso de las unidades de implementación del entorno seleccionado.

Próximos pasos

Obtén información sobre cómo implementar: Implementa un proxy de API

Obtén información sobre cómo anular una implementación: Anula la implementación de un proxy de API