Descripción general de la implementación

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.

Ciclo de vida de la implementación del proxy de API de Apigee que muestra el plano de administración, el plano de tiempo de ejecución y el título de Operaciones en la nube=

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:

  1. La revisión 1 del proxy API /hello está implementada y maneja el tráfico.
  2. Se ha implementado la revisión 2 de /hello .
  3. La revisión 2 se implementa en los procesadores de mensajes en el plano de ejecución.
  4. 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
  1. Seleccione Desarrollar > Proxies de API :

    Shows one-fish API proxy with status as currently deployed (green dot icon)

La interfaz de usuario de Apigee utiliza los siguientes íconos para brindar un estado rápido de cada proxy API:

Gray dot icon indicates API proxy is not deployed to selected environment Indica que el proxy API no se ha implementado en el entorno seleccionado.
Green dot icon indicates API proxy deployed without errors or warnings in selected environment Indica que no hay errores ni advertencias para ese proxy en el entorno seleccionado.
Yellow triange icon indicates that some routing did not update due to base path conflicts Indica que alguna ruta no se actualizó debido a conflictos en la ruta base.
Red box icon indicates there was an error during deployment Indica que hubo un error al implementar el 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:

  1. Abra la página Descripción general en la interfaz de usuario de Apigee en Google Cloud consola.

    Ir a la descripción general

  2. 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 :

  1. Abra la página Proxies de API en la interfaz de usuario de Apigee en Google Cloud consola.

    Ir a los servidores proxy de API

  2. 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 :

  1. Abra la página Entornos en la interfaz de usuario de Apigee en Google Cloud consola.

    Ir a Entornos

  2. 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.
  3. Para ver el uso de la implementación del proxy para un solo entorno:
    1. En la lista Entornos , seleccione un nombre de entorno para ver sus detalles.
    2. 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:

Implementación de un proxy API

Aprenda cómo anular la implementación:

Cómo anular la implementación de un proxy de API