Esta página se aplica a Apigee y Apigee Hybrid.
Consulta la documentación de
Apigee Edge.
Cuando realizas un cambio en un proxy de API, puedes guardarlo como una revisión nueva y, luego, implementarlo en tu clúster.
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.
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:
- Se implementa la revisión 1 del proxy de API
/helloy controla el tráfico. - Se implementa la revisión 2 de
/hello. - La revisión 2 se implementa en los Message Processors en el plano del entorno de ejecución.
- 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.
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 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 |
La IU de Apigee usa los siguientes íconos a fin de proporcionar un estado rápido para cada 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. |
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.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.
Próximos pasos
|
Obtén información sobre cómo implementar:
|
Obtén información sobre cómo anular una implementación: Anula la implementación de un proxy de API
|