Vuelve a crear una instancia de Apigee sin tiempo de inactividad

Esta página se aplica a Apigee, pero no a Apigee Hybrid.

Consulta la documentación de Apigee Edge.

En este documento, se explica cómo volver a crear una instancia de Apigee sin incurrir en tiempo de inactividad de administración de API ni pérdida de datos.

Introducción

Las instancias de Apigee creadas antes del 25 de enero de 2022 no tienen suficiente espacio de direcciones de protocolo de Internet (IP) para permitir que las cargas de trabajo de Apigee escalen a fin de manejar el aumento del tráfico de la API o agregar más de 10 entornos a una instancia.

El 24 de enero de 2022, Apigee presentó una mejora para abordar este problema. La mejora reduce el rango de IP necesario para intercambiar tráfico entre tu red de VPC y Apigee, y usa IP públicas de uso privado (PUPI) a fin de permitir que las cargas de trabajo escalen a límites más altos.

Qué debe hacer

Si tienes una instancia de Apigee que se creó antes del 25 de enero de 2022, Apigee recomienda que la reemplaces por una nueva, como se explica en este documento. Si no vuelves a crear la instancia anterior, es posible que experimentes problemas de escalamiento y la cantidad de entornos que puedes agregar a una instancia seguirá limitada a 10. Además, es posible que tu instancia deje de recibir actualizaciones periódicas, lo que afectará los servicios de la API.

Determina la fecha de creación de una instancia

Para determinar la fecha de creación de una instancia de Apigee, haz lo siguiente:

Obtén una lista de los detalles de todas las instancias de Apigee en la organización:

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"

curl -i -X GET -H "$AUTH" \
"https://apigee.googleapis.com/v1/organizations/PROJECT_ID/instances"

Aquí:

AUTH es el encabezado de autenticación con un token del portador. Asegúrate de que el proyecto predeterminado para gcloud esté configurado como PROJECT_ID.
PROJECT_ID es el ID del proyecto de Cloud que creaste cuando aprovisionaste Apigee.

Resultado de muestra:

{
  "instances": [
    {
      "name": "us-west1",
      "location": "us-west1",
      "host": "10.117.200.2",
      "port": "443",
      "createdAt": "1642698826000",
      "lastModifiedAt": "1655745226000",
      "diskEncryptionKeyName": "projects/myproject/locations/us-west1/keyRings/my-key-ring/cryptoKeys/my-key",
      "state": "ACTIVE",
      "peeringCidrRange": "SLASH_22",
      "runtimeVersion": "1-8-0-apigee-33",
      "ipRange": "10.117.200.0/22,10.81.174.192/28",
      "consumerAcceptList": [
        "myproject"
      ],
      "serviceAttachment": "projects/z11f28c6f3104980e-tp/regions/us-west1/serviceAttachments/apigee-us-west1-lbko"
    }
  ]
}

Para cada instancia, verifica el valor del campo createdAt mediante la decodificación de la marca de tiempo de Unix a fin de obtener la fecha.
- Si una instancia se creó a partir del 25 de enero de 2022, no debes hacer nada más con respecto a ella.
- Si una instancia se creó antes del 25 de enero de 2022, te recomendamos reemplazarla, como se explica en este documento.

Acerca del procedimiento de recreación

Para volver a crear una instancia sin tiempo de inactividad ni pérdida de datos, primero debes crear una instancia nueva en una región nueva (expandida) y dirigir el tráfico de la API a esa nueva instancia. Luego, puedes desviar la instancia existente, borrarla y volver a crearla en la misma región de la instancia que borraste.

Apigee proporcionó un conjunto de secuencias de comandos que realizan todos los pasos necesarios para volver a crear y configurar una instancia. Proporcionaremos un vínculo a las secuencias de comandos más adelante en este documento.

Requisitos previos

Antes de comenzar los pasos de recreación de la instancia, debes cumplir con estos requisitos:

Debes estar familiarizado con la forma en que se creó la instancia de Apigee. Los pasos para volver a crear la instancia dependen de que sepas los detalles sobre cómo se configuró la instancia original.
Debes tener derecho a aprovisionar Apigee en al menos dos regiones. Si no estás seguro de tener los derechos suficientes, sigue los pasos para crear una instancia en una región nueva. Si no tienes los derechos adecuados, el intento fallará con un error de límite. En ese caso, comunícate con el equipo de asistencia de Apigee para obtener una excepción temporal a fin de aumentar el límite de tu región. Si ya tienes acceso a dos o más regiones, te recomendamos que te comuniques con el equipo con el fin de obtener la excepción temporal para evitar ejecutar tu carga de trabajo de producción con una instancia reducida durante el proceso de recreación.
El proceso de volver a crear una instancia incluye borrar la instancia anterior. Si no sigues el paso para crear una instancia nueva en una región expandida, incurrirás en tiempo de inactividad y pérdida de datos del entorno de ejecución, incluidas las KVMs, los datos de caché, los datos de cuota y los datos de KMS. Por lo tanto, la expansión regional es obligatoria para volver a crear una instancia sin tiempo de inactividad ni pérdida de datos.
Debes tener espacio en tu proyecto para los rangos de IP adicionales de bloques /22 y /28 a fin de crear la nueva instancia. Consulta también Tamaño de red. Puedes liberar estos rangos cuando se borre la región adicional después de que se complete la recreación de la instancia. Ten en cuenta que puedes configurar el bloque /22. Puedes elegir qué bloque /28 usará Apigee, o si no eliges, lo asigna Apigee desde cualquier bloque disponible de forma automática.

Vuelve a crear la instancia

Apigee proporcionó un conjunto de secuencias de comandos que realizan todos los pasos necesarios para volver a crear una instancia.

Asegúrate de que cumples con los requisitos.
Descarga las secuencias de comandos desde GitHub.
Sigue los pasos del archivo README del repositorio de Git para crear la instancia nueva.
Vuelve a configurar las conexiones ascendentes y descendentes para apuntar a la nueva instancia de Apigee. Consulta Acerca de los cambios ascendentes y Acerca de los cambios descendentes.

Acerca de los cambios ascendentes

Ascendente hace referencia al tráfico de la API de clientes externos o internos a Apigee a través de un balanceador de cargas. Cuando se borra y se vuelve a crear una instancia, la dirección IP ascendente y el ID de adjunto de servicio de Private Service Connect (PSC) de la instancia cambiarán para la instancia nueva.

Las secuencias de comandos proporcionadas reconfiguran el backend del balanceador de cargas por ti. Si el enrutamiento de red de la instancia se configuró con un grupo de instancias administrado (MIG), una secuencia de comandos proporcionada vuelve a crear el MIG que actúa como proxy para el tráfico al extremo de Apigee y adjunta el MIG. como un backend para el servicio de backend existente. Si el enrutamiento se configuró con Private Service Connect (PSC), una secuencia de comandos vuelve a crear el grupo de extremos de red (NEG) en el adjunto de extremo de servicio de Apigee y conecta el NEG nuevo como un backend al servicio de backend existente.

Ten en cuenta que no tendrás que cambiar los registros de nombre de host en ningún grupo de entorno asociado con la instancia anterior.

Cambios descendentes

Descendente hace referencia al tráfico de la API de Apigee a los servicios de destino del proxy de API.

Cuando se borra y se vuelve a crear una instancia, se liberan las direcciones IP de NAT dedicadas descendentes. Por lo tanto, debes reservar y activar direcciones IP nuevas para NAT y volver a configurar tus firewalls o listas de entidades permitidas en los extremos de destino. Una de las secuencias de comandos proporcionadas controla esta reconfiguración de NAT por ti, si es necesario.