Esta página se aplica a Apigee y Apigee híbrido .
Ver la documentación de Apigee Edge .
Cuando realiza un cambio en un proxy de API, puede guardarlo como una nueva revisión e implementarlo en su clúster.
Acerca de la implementación
El ciclo de vida de implementación de una revisión de proxy de API en Apigee se muestra en la siguiente figura.
Limitaciones de las revisiones del proxy API
Las siguientes limitaciones se aplican a las revisiones de proxy de API:
- Si realiza algún cambio en un proxy API, debe implementarlo como una nueva revisión.
- Tras implementar un proxy de API, la revisión es de solo lectura. No se puede modificar una revisión de proxy de API (por ejemplo, para realizar cambios incrementales); la única forma de hacerlo es crear una nueva revisión e implementarla.
- Los MP solo pueden implementar un paquete de proxy en su totalidad. Si se realizan cambios en fragmentos o políticas individuales, los MP seguirán implementando el paquete de proxy completo.
- Si su uso de Apigee distingue entre servidores proxy estándar y extensibles , al implementar una revisión que cambia un proxy de API de un proxy estándar a un proxy extensible:
- Podría incurrir en un costo. Si es cliente de pago por uso, consulte los derechos de pago por uso . Si es cliente de suscripción, consulte los detalles de su plan.
- La implementación requiere tiempo adicional. Durante el período de implementación, el flujo de llamadas a la API no se interrumpe, pero no se puede implementar, anular la implementación ni eliminar el proxy. Además, no se pueden eliminar las revisiones actuales ni las nuevas durante el período de implementación. Se permiten cambios en el proxy de la API y la creación de nuevas revisiones.
Implementación sin tiempo de inactividad
Todas las implementaciones exitosas de proxy de API en Apigee son implementaciones sin tiempo de inactividad . Las implementaciones de proxy de API se realizan en este orden:
- La revisión 1 del proxy API
/hello
está implementada y maneja el tráfico. - Se ha implementado la revisión 2 de
/hello
. - La revisión 2 se implementa en los procesadores de mensajes en el plano de ejecución.
- La revisión 1 no está implementada.
La implementación de la revisión del proxy API ahora está completa sin tiempo de inactividad.
Visualización del estado de la implementación
Implementar un proxy de API en Apigee no lo hace disponible de inmediato. Su sincronización con todos los procesadores de mensajes (MP) en el plano de ejecución lleva tiempo. Sin embargo, Apigee proporciona herramientas que pueden brindarle información sobre el estado de las revisiones de su proxy de API.
Interfaz de usuario clásica de Apigee
Dentro de la interfaz de usuario de Apigee, hay varias vistas que proporcionan el estado de implementación de sus servidores proxy API.
Vista de interfaz de usuario de Apigee | Pasos y descripción |
---|---|
Proxies |
La interfaz de usuario de Apigee utiliza los siguientes íconos para brindar un estado rápido de cada proxy API:
Para ver el icono de estado, haga clic en la pestaña Desarrollar . Alternativamente, 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 su revisión de proxy de API en un entorno, utilice la siguiente llamada de API:
curl "https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/deployments" \ -X GET \ -H "Authorization: Bearer $TOKEN"
Donde $TOKEN
se establece en su token de acceso de OAuth 2.0, como se describe en "Obtención de un token de acceso de OAuth 2.0" . Para obtener información sobre las opciones curl
utilizadas en este ejemplo, consulte "Uso de curl" . Para obtener una descripción de las variables de entorno utilizadas, consulte "Configuración de variables de entorno para solicitudes de la API de Apigee" .
A continuación, se muestra un ejemplo de la respuesta. Este ejemplo muestra el estado de implementación de la revisión 1
del proxy de la API helloworld
implementado 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, consulte la API de implementaciones del entorno de revisión de proxy de API .
nube g
Para ver el estado de implementación de su revisión de proxy de API en un entorno, use el siguiente comando 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, consulte Primeros pasos para usar gcloud con Apigee .
A continuación, se muestra un ejemplo de la respuesta. Este ejemplo muestra el estado de implementación de la revisión 1
del proxy de la API helloworld
implementado 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, consulte Describir implementaciones CLI .
Ver el uso de la implementación del proxy
El uso de proxies de API en su organización puede estar sujeto a una cuota de despliegues, que limita la cantidad de unidades de despliegue que puede usar simultáneamente. Consulte sus derechos ( pago por uso o suscripción ) para obtener más información. Puede consultar el uso de despliegue de proxy de su organización desde varios lugares dentro de la interfaz de usuario de Apigee en la consola de Cloud , como se describe a continuación.
Ver el uso de la implementación en la página Descripción general de Apigee
Para ver el uso de la implementación del proxy API desde la página Descripción general de Apigee:
- Abra la página Descripción general en la interfaz de usuario de Apigee en Google Cloud consola.
- Puede ver el uso de implementación de proxy para su organización de un vistazo utilizando la tarjeta Uso de proxy , que muestra la siguiente información para su organización:
- Total de proxies creados : la cantidad total de proxies de API creados, incluidos los proxies implementados y no implementados.
- Proxies implementados : la cantidad total de proxies de API implementados en todos los entornos de la organización.
- Unidades de implementación de proxy : El número total de revisiones de proxy de API o flujos compartidos implementadas en su organización. Cada implementación por entorno, por instancia, se contabiliza como una unidad.
- Proxies y flujos compartidos implementados contra el límite : cantidad total de proxies de API y flujos compartidos implementados en la organización, contra el límite para su tipo de organización.
- Unidades de implementación extensibles : El número de revisiones de proxy de API extensibles implementadas en su organización. Cada implementación por entorno, por instancia, se contabiliza como una unidad.
- Unidades de implementación estándar : Número de revisiones de proxy de API estándar implementadas en su organización. Cada implementación por entorno y por instancia se contabiliza como una unidad.
Ver el uso de la implementación en la página de Proxies de API
Para ver el uso de la implementación del proxy de API desde la página Proxies de API :
- Abra la página Proxies de API en la interfaz de usuario de Apigee en Google Cloud consola.
- La página Proxies de API muestra la siguiente información:
- Total de proxies creados : la cantidad total de proxies de API desarrollados en su organización, incluidos los proxies implementados y no implementados.
- Proxies implementados : la cantidad total de revisiones de proxy de API implementadas en todos los entornos de su organización.
- Unidades de implementación de proxy : El número total de revisiones de proxy de API o flujos compartidos implementadas en todos los entornos de su organización. Cada implementación por entorno y por instancia se contabiliza como una unidad.
- Unidades de implementación de proxy extensible : Número de revisiones de proxy de API extensible implementadas en todos los entornos de su organización. Cada implementación por entorno y por instancia se contabiliza como una unidad.
- Unidades de implementación de proxy estándar : El número de revisiones de proxy de API estándar implementadas en todos los entornos de su organización. Cada implementación por entorno, por instancia, se contabiliza como una unidad.
Ver el uso de la implementación en la página Entornos
Para ver el uso de la implementación del proxy API desde la página Entornos :
- Abra la página Entornos en la interfaz de usuario de Apigee en Google Cloud consola.
- Seleccione la pestaña Descripción general de entornos para mostrar la siguiente información para todos los entornos:
- Unidades totales de implementación de proxy : la cantidad total de revisiones de flujo compartido o proxy de API implementadas en todos los entornos de su organización.
- Unidades de implementación de proxy extensible : Número de revisiones de proxy de API extensible implementadas en todos los entornos de su organización. Cada implementación por entorno y por instancia se contabiliza como una unidad.
- Unidades de implementación de proxy estándar : El número de revisiones de proxy de API estándar implementadas en todos los entornos de su organización. Cada implementación por entorno, por instancia, se contabiliza como una unidad.
- Unidades de implementación de flujo compartido : El número total de revisiones de flujo compartido implementadas en todos los entornos de su organización. Cada implementación por entorno, por instancia, se contabiliza como una unidad.
- Para ver el uso de la implementación del proxy para un solo entorno:
- En la lista Entornos , seleccione un nombre de entorno para ver sus detalles.
- Seleccione la pestaña Implementaciones para ver el uso de la unidad de implementación para el entorno seleccionado.
Próximos pasos
Aprenda a implementar: | Aprenda cómo anular la implementación: |