¿Cómo soluciono los problemas de actualización de bases de datos compatibles con Aurora MySQL?

Descripción corta

Si utilizas un despliegue azul-verde para actualizar una base de datos compatible con Aurora MySQL, es posible que el despliegue muestre «Configuración no válida» para el estado de la actualización. Para obtener más información sobre el problema, consulta los registros y eventos de la instancia del escritor para ver el siguiente mensaje:

«Failed to provision due to upgrade incompatibilities».

Para resolver este error, sigue estos pasos de solución de problemas.

Resolución

Prepárate para el despliegue azul-verde

Para reducir los problemas relacionados con el despliegue azul-verde, sigue estas prácticas recomendadas para prepararte para el despliegue:

• Revisa la matriz de compatibilidad de versiones de Aurora MySQL para asegurarte de que puedes actualizar tu versión actual a la versión de destino con despliegue azul-verde. Para obtener más información, consulta Comprobación de los números de versión de Aurora MySQL.
• Evalúa la capacidad de tu aplicación para gestionar interrupciones breves durante la transición. También puedes implementar la lógica de reintento de conexión en el código de la aplicación para facilitar el proceso de transición. Para obtener más información, consulta Prácticas recomendadas generales para los despliegues azul-verde.
• Revisa todos los ajustes de configuración para asegurarte de que la versión actual es compatible con la versión de destino.
• Crea una copia de seguridad de tu base de datos actual para asegurarte de que puedes revertirla si es necesario.

Ejecución del despliegue azul-verde

Durante el despliegue, completa las siguientes tareas:

• Utiliza las métricas de Amazon CloudWatch, Amazon EventBridge y los registros para supervisar el progreso de la actualización.
• Si actualizas a una versión secundaria más reciente dentro de la misma versión principal, utiliza la característica de actualización local en el clúster verde. Esta característica te permite acceder a la última versión del parche antes de completar el proceso de transición.
• Después de validar que el entorno verde está listo y que el clúster verde no tiene ningún retraso en la réplica, completa la transición durante un periodo de mantenimiento planificado.

Si la conmutación se detiene o se ralentiza durante la transición, consulta los registros de errores para ver si hay mensajes de error o cuellos de botella específicos. Puedes especificar un periodo de tiempo de espera de conmutación entre 30 segundos y 3600 segundos (1 hora). Si la conmutación dura más de lo especificado, Aurora restaura los cambios y no cambia ninguno de los entornos.

Nota: El periodo de tiempo de espera predeterminado es de 300 segundos (5 minutos).

Uso de enfoques de actualización alternativos

Para algunas actualizaciones, como de Aurora sin servidor v1 a Aurora sin servidor v2, no puedes usar el proceso de despliegue azul-verde. Para solucionar este problema, utiliza uno de estos métodos:

Uso de réplicas de lectura

Haz lo siguiente:

1. Crea una réplica de lectura de tu clúster Aurora sin servidor v1.
2. Actualiza la réplica de lectura del clúster a Aurora sin servidor v2.
3. Actualiza la réplica de lectura para que sea el clúster principal.

Para obtener más información, consulta Actualización de un clúster de Aurora sin servidor v1 a Aurora sin servidor v2.

Uso de la restauración de instantáneas

Haz lo siguiente:

1. Crea una instantánea de tu clúster de Aurora sin servidor v1.
2. Restaura la instantánea en un nuevo clúster de Aurora sin servidor v2.
3. Actualiza la aplicación para que apunte al nuevo clúster de la versión 2.

Revisión de las configuraciones después de la actualización

Tras completar la actualización del clúster, comprueba que todas las funciones de la base de datos, los procedimientos almacenados y las consultas de la aplicación funcionan según lo previsto. Supervisa las métricas de rendimiento durante un periodo de 24 a 48 horas después de la actualización, incluidas las horas punta, para asegurarte de que no se produzcan efectos inesperados en el rendimiento.

Pasos de solución de problemas adicionales

Error de incompatibilidad

Si la configuración actual de la base de datos usa parámetros o características que no son compatibles con la base de datos de destino, recibirás el siguiente mensaje de error:

«Failed to provision due to upgrade incompatibilities. See https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.mysql80-upgrade-procedure.html#AuroraMySQL.mysql80-upgrade-troubleshooting to resolve these issues, then delete and recreate this Blue/Green Deployment».

Para resolver este error, sigue estos pasos:

1. Revisa el archivo upgrade-prechecks.log en tu base de datos compatible con Aurora MySQL.
2. Soluciona cualquier problema de compatibilidad que identifiques en el archivo de registro. Para obtener más información, consulta Resumen de comprobaciones previas de actualizaciones de Community MySQL y Resumen de comprobaciones previas de actualizaciones de Aurora MySQL.
3. Elimina el despliegue azul-verde.
4. Vuelve a crear el despliegue azul-verde.

Error de compatibilidad de parámetros

Si tu clúster verde tiene un estado de parámetros incompatibles y no está disponible, los parámetros del clúster o los valores de los parámetros de instancia existentes no son compatibles con la versión de destino.

Para resolver este error, sigue estos pasos:

1. Restablece los grupos de parámetros del clúster y los valores de los parámetros de instancia.

2. Para convertir el clúster verde en un clúster independiente, ejecuta el comando promote-read-replica-db-cluster:

   aws rds promote-read-replica-db-cluster --db-cluster-identifier <Green Cluster>

3. Elimina el clúster y la instancia.

4. Revisa la compatibilidad de los valores de los parámetros del clúster existente con la versión de destino. O bien, cambia a los valores predeterminados en el clúster azul. A continuación, cambia los valores de los parámetros de uno en uno durante la transición al clúster verde.

5. Tras validar los parámetros, crea un nuevo entorno azul-verde.

Solución de problemas de una actualización estancada

El clúster verde puede estancarse durante la actualización por los siguientes motivos:

• Incompatibilidad con la versión de destino
• Las transacciones de larga duración en el clúster azul bloquean el proceso de actualización en el clúster verde

Para solucionar el error, lleva a cabo estas tareas:

1. Comprueba si la versión actualizada es compatible con la versión de destino para la actualización directa.
2. Si la versión no es compatible, revierte los cambios y elimina el despliegue azul-verde.
3. Actualiza a la versión intermedia recomendada. Por último, actualiza a la versión final.

También puedes supervisar tu clúster azul para ver si hay transacciones de duración prolongada. Si hay transacciones de duración prolongada, completa o finaliza las transacciones. A continuación, vuelve a intentar el proceso de actualización.

Información relacionada

¿Cómo puedo actualizar mi clúster de base de datos de Amazon Aurora MySQL a una nueva versión?

Upgrade to Amazon Aurora MySQL version 3 (with MySQL 8.0 compatibility) (Actualización a la versión 3 de Amazon Aurora MySQL [con compatibilidad con MySQL 8.0])

Performing major version upgrades for Amazon Aurora MySQL with minimum downtime (Realización de actualizaciones principales de la versión de Amazon Aurora MySQL con un tiempo de inactividad mínimo)

Actualización de la versión principal de un clúster de base de datos de Amazon Aurora MySQL