Volver 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.

Importante: Este tema solo se aplica a las organizaciones que se crearon con el peering de VPC habilitado. Consulta también las opciones de redes de Apigee.

En este documento se explica cómo recrear una instancia de Apigee sin que se produzca un tiempo de inactividad en la gestión de APIs ni se pierdan datos.

Introducción

Las instancias de Apigee creadas antes del 25 de enero del 2022 no tienen suficiente espacio de direcciones del protocolo de Internet (IP) para permitir que las cargas de trabajo de Apigee se escalen para gestionar el aumento del tráfico de las APIs o para permitirte añadir más de 10 entornos a una instancia.

El 24 de enero del 2022, Apigee introdujo una mejora para solucionar este problema. Esta mejora reduce el intervalo de IPs necesario para emparejar tu red de VPC con Apigee y usa IPs públicas usadas de forma privada (PUPI) para permitir que las cargas de trabajo se escalen a límites más altos.

Qué debes hacer

Si tienes una instancia de Apigee creada antes del 25 de enero del 2022, Apigee te recomienda que la sustituyas por una nueva, tal como se explica en este documento. Si no vuelves a crear la instancia anterior, es posible que tengas problemas de escalado y que el número de entornos que puedes añadir a una instancia siga limitado a 10. Además, es posible que tu instancia deje de recibir actualizaciones periódicas, lo que afectará a los servicios de la API.

Determinar la fecha de creación de una instancia

Para determinar la fecha de creación de una instancia de Apigee, sigue estos pasos:

1. Consulta los detalles de todas las instancias de Apigee de tu 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"

   Donde:

   • AUTH es el encabezado de autenticación con un token de portador. Asegúrate de que el proyecto predeterminado de gcloud sea PROJECT_ID.
   • PROJECT_ID es el ID del proyecto de Cloud que creaste al aprovisionar Apigee.

   Ejemplo de salida:

   {
     "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"
       }
     ]
   }

2. En cada instancia, compruebe el valor del campo createdAt decodificando la marca de tiempo de Unix para obtener la fecha.
   • Si se creó una instancia el 25 de enero del 2022 o después, no tienes que hacer nada más con ella.
   • Si se creó una instancia antes del 25 de enero del 2022, te recomendamos que la sustituyas, tal como se explica en este documento.

Acerca del procedimiento de recreación

Para recrear una instancia sin tiempo de inactividad y sin pérdida de datos, primero debes crear una instancia en una región nueva (ampliada) y dirigir el tráfico de la API a esa instancia. Después, puedes vaciar la instancia, eliminarla y volver a crearla en la misma región que la que has eliminado.

Apigee ha proporcionado un conjunto de secuencias de comandos que realizan todos los pasos necesarios para recrear y configurar una instancia. Proporcionamos un enlace a las secuencias de comandos más adelante en este documento.

Requisitos previos

Antes de empezar a recrear la instancia, haz lo siguiente:

• Debe saber cómo se creó la instancia de Apigee. Los pasos para recrear la instancia dependen de si conoces los detalles de cómo se configuró la instancia original.
• Debes tener derecho a aprovisionar Apigee en al menos dos regiones. Si no sabes si tienes derechos suficientes, sigue los pasos para crear una instancia en una región nueva. Si no tienes el derecho adecuado, el intento fallará y se producirá un error de límite. En ese caso, póngase en contacto con el equipo de Asistencia de Apigee para obtener una excepción temporal que le permita aumentar el límite de su región. Si ya tienes derecho a dos o más regiones, te recomendamos que te pongas en contacto con nosotros para obtener la excepción temporal y evitar que tu carga de trabajo de producción se ejecute con una instancia reducida durante el proceso de recreación.
  El proceso de recreación de una instancia incluye la eliminación de la instancia antigua. Si no sigues el paso para crear una instancia en una región ampliada, se producirá un tiempo de inactividad y una pérdida de datos de tiempo de ejecución, incluidos los KVMs, los datos de caché, los datos de cuota y los datos de KMS. Por lo tanto, es obligatorio ampliar la región para recrear una instancia sin tiempo de inactividad ni pérdida de datos.
• Tu proyecto debe tener espacio para rangos de IPs adicionales de bloques /22 y /28 para crear la nueva instancia. Consulta también Tamaño de la red. Puedes liberar estos intervalos cuando se elimine la región adicional una vez que se haya completado la recreación de la instancia. Ten en cuenta que el bloque /22 lo puedes configurar tú. Puedes elegir el bloque /28 que usará Apigee o, si no lo haces, Apigee lo asignará automáticamente de entre los bloques disponibles.

Recrear la instancia

Apigee ha proporcionado un conjunto de secuencias de comandos que realizan todos los pasos necesarios para recrear una instancia.

1. Asegúrate de que cumples los requisitos previos.
2. Descarga las secuencias de comandos de GitHub.
3. Sigue los pasos del archivo README del repositorio de Git para crear la nueva instancia.
4. Vuelve a configurar las conexiones de entrada y salida para que apunten a la nueva instancia de Apigee. Consulta Información sobre los cambios de entrada y Información sobre los cambios de salida.

Acerca de los cambios de entrada

El término "de entrada" hace referencia al tráfico de APIs de clientes externos o internos a Apigee a través de un balanceador de carga. Cuando se elimina una instancia y se vuelve a crear, la dirección IP de salida y el ID de vinculación de servicio de Private Service Connect (PSC) de la instancia cambiarán en la nueva instancia.

Las secuencias de comandos proporcionadas vuelven a configurar el backend del balanceador de carga. Si la ruta de red de la instancia se configuró con un grupo de instancias gestionado (MIG), un script proporcionado recrea el MIG que proxyiza el tráfico al endpoint de Apigee y adjunta el MIG como backend al servicio de backend. Si la ruta se configuró con Private Service Connect (PSC), una secuencia de comandos recrea el grupo de endpoints de red (NEG) en el adjunto de endpoint de servicio de Apigee y adjunta el nuevo NEG como backend al servicio de backend.

Ten en cuenta que no tendrás que cambiar los registros de nombre de host en ningún grupo de entornos asociado a la instancia antigua.

Cambios en la dirección sur

El tráfico de salida hace referencia al tráfico de APIs de Apigee a los servicios de destino de tu proxy de API.

Nota: Los cambios de salida solo son necesarios si has usado IPs de NAT para instancias de Apigee, tal como se describe en Provisioning NAT IPs (Provisionar IPs de NAT).

Cuando se elimina y se vuelve a crear una instancia, se liberan todas las direcciones IP de NAT de salida dedicadas. Por lo tanto, debes reservar y activar nuevas direcciones IP para tu NAT y volver a configurar tus cortafuegos o listas de permitidos en tus endpoints de destino. Una de las secuencias de comandos proporcionadas se encarga de esta reconfiguración de NAT, si es necesario.