Administra las actualizaciones de mantenimiento de AlloyDB con un clúster de etapa de pruebas

Para minimizar el riesgo para tus cargas de trabajo de producción de AlloyDB para PostgreSQL, puedes usar un clúster de etapa de pruebas para probar las nuevas funciones, el rendimiento y la funcionalidad antes de aplicar las actualizaciones a tus sistemas de producción. Un clúster de etapa de pruebas es una copia de tu clúster de producción que agrega una capa de control al proceso de actualización de mantenimiento. Si usas un clúster de etapa de pruebas para probar las actualizaciones de mantenimiento, puedes identificar y abordar posibles problemas en un entorno que no es de producción. Este enfoque reduce el riesgo de tiempo de inactividad y degradación del rendimiento en tus sistemas de producción.

Las actualizaciones de mantenimiento de AlloyDB son periódicas y, a menudo, mensuales. Las actualizaciones incluyen funciones nuevas, correcciones de errores, actualizaciones de compatibilidad de bases de datos y correcciones relacionadas con la seguridad. Si bien las versiones de AlloyDB son compatibles con versiones posteriores, te recomendamos que pruebes las versiones nuevas en un entorno de etapa de pruebas para garantizar la estabilidad y la previsibilidad de la base de datos para las aplicaciones críticas en tu clúster de producción. Para obtener más información, consulta Descripción general del mantenimiento.

Para usar un clúster de etapa de pruebas, sigue estos pasos generales:

  1. Configura un clúster de etapa de pruebas.
  2. Configura un período de mantenimiento en un clúster de producción.
  3. Administra las actualizaciones del clúster de etapa de pruebas.
  4. Administra las actualizaciones del clúster de producción.

Este enfoque de validación de etapa de pruebas para el mantenimiento de AlloyDB garantiza que tu entorno de producción siga siendo estable, con buen rendimiento y seguro, a la vez que se beneficia de las funciones y los parches más recientes de AlloyDB.

En el siguiente diagrama, se muestra la relación entre tu clúster de etapa de pruebas y el clúster de producción, y el flujo operativo del proceso de actualización:

Relación entre los clústeres de producción y de etapa de pruebas

Para obtener más información sobre cómo funcionan las actualizaciones de mantenimiento con los clústeres de AlloyDB, consulta Descripción general del mantenimiento. Para obtener más información sobre la administración de períodos de mantenimiento, consulta Administra los períodos de mantenimiento de los clústeres de AlloyDB para PostgreSQL.

Antes de comenzar

El Google Cloud proyecto que usas debe estar habilitado para acceder a AlloyDB.

Para configurar un clúster de etapa de pruebas, debes crear o tener un clúster de producción de AlloyDB existente. Para obtener más información, consulta Crea un clúster y su instancia principal.

Debes tener uno de los siguientes roles de IAM en el Google Cloud proyecto que usas:

  • roles/alloydb.admin: El rol de IAM predefinido de administrador de AlloyDB
  • roles/owner: El rol de IAM básico de propietario
  • roles/editor: El rol de IAM básico de editor

Si no tienes ninguno de estos roles, comunícate con el administrador de tu organización para solicitar acceso.

Configura un clúster de etapa de pruebas

La clave para una estrategia exitosa de etapa de pruebas primero es asegurarse de que tu clúster de etapa de pruebas sea similar a tu entorno de producción y que reciba actualizaciones antes de la producción. Configuras una estrategia de etapa de pruebas primero cuando no estableces un período de mantenimiento en tu clúster de etapa de pruebas. AlloyDB primero actualiza los clústeres sin períodos de mantenimiento.

Crea un clúster de etapa de pruebas a partir de tu copia de seguridad de producción

Implementa un clúster de etapa de pruebas que refleje tu entorno de producción y asegúrate de que tu clúster de etapa de pruebas tenga la misma versión, configuración y datos de AlloyDB que tu clúster de producción.

Para asegurarte de que tu clúster de etapa de pruebas sea idéntico a tu entorno de producción, usa el comando restore para clonar tu base de datos de producción en tu clúster de etapa de pruebas y asegurarte de que los datos sean similares y la configuración coincida. También te recomendamos que separes los entornos de etapa de pruebas y de producción en diferentes proyectos.

Puedes usar los siguientes dos métodos para crear una copia de seguridad de producción:

  • Crea un clúster de etapa de pruebas nuevo realizando un restablecimiento completo de una copia de seguridad de un clúster de producción existente. Este método no implica la recuperación de una base de datos. Sin embargo, según la programación de la copia de seguridad, los datos pueden tener hasta 24 horas de antigüedad. Para usar este método, consulta Restablece un clúster a partir de una copia de seguridad almacenada.
  • Crea un clúster de etapa de pruebas nuevo realizando la recuperación de un momento determinado (PITR) a un momento específico de una copia de seguridad de la base de datos de producción existente, incluido el momento más reciente. Con esta opción, obtienes los datos más recientes y el método es más sencillo. Sin embargo, según la última hora de la copia de seguridad de PITR, es posible que tarde más en restablecer o recuperar los datos al momento que especifiques. Para usar este método, consulta Usa la recuperación de un momento determinado (PITR).

Verifica que no se haya establecido un período de mantenimiento en el clúster de etapa de pruebas

No establezcas un período de mantenimiento para tu clúster de etapa de pruebas. De forma predeterminada, los clústeres de AlloyDB recién creados, incluso los que restableces a partir de una copia de seguridad, no tienen un período de mantenimiento establecido. Este es el estado correcto para tu entorno de etapa de pruebas. AlloyDB actualiza los clústeres que no tienen períodos de mantenimiento programados antes de actualizar los clústeres con períodos de mantenimiento programados.

Puedes verificar que no haya un período de mantenimiento establecido de la siguiente manera:

Console

  1. Ve a la página Clústeres.

    Ir a los clústeres

  2. Haz clic en un clúster en la columna Nombre del recurso. Se abrirá la página Descripción general.

  3. En la página Descripción general, en la sección Mantenimiento, consulta los detalles del período de mantenimiento de tu clúster.

    Google Cloud

  4. Opcional: En la página Estadísticas del sistema, puedes ver los detalles del estado de la operación de mantenimiento, como la Cronología de eventos.

  5. Para ver la administración de Mantenimiento unificado, ingresa "Mantenimiento de Cloud Hub" en la barra de búsqueda y selecciona Mantenimiento. En esta página, puedes ver un resumen de mantenimiento, el mantenimiento controlado por Google y los detalles del mantenimiento planificado.

gcloud

  1. Para usar gcloud CLI, puedes instalar y, luego, inicializar Google Cloud CLI, o bien puedes usar Cloud Shell.

    gcloud alloydb clusters describe STAGING_CLUSTER_ID \
    --region=LOCATION_ID \
    --project=PROJECT_ID

  2. Busca el campo maintenanceSchedule en el resultado. Si no se establece ningún período de mantenimiento, este campo no está presente o está vacío. Si, por algún motivo, se establece un período de mantenimiento, bórralo.

    gcloud alloydb clusters update STAGING_CLUSTER_ID \
    --region=LOCATION_ID \
    --clear-maintenance-window \
    --project=PROJECT_ID

Administra varios canales de versiones para varios entornos que no son de producción

Si tu organización tiene una cadencia de versiones bien definida y sólida, y tienes varios entornos que no son de producción, es posible que desees aplicar las versiones nuevas paso a paso. Por ejemplo, es posible que desees aplicar una versión en la siguiente secuencia:

  1. Entorno de desarrollo
  2. Entorno de control de calidad
  3. Entorno de etapa de pruebas

Para obtener un control más detallado sobre tu cronograma de versiones en AlloyDB, puedes usar el mantenimiento de autoservicio. El mantenimiento de autoservicio te permite aplicar manualmente una versión nueva a cualquier entorno en cualquier momento.

Para implementar este tipo de cadencia de versiones, sigue estos pasos generales:

  1. Aplica el rechazo del mantenimiento a todos tus entornos que no son de producción para asegurarte de que no reciban actualizaciones automáticamente.
  2. Usa el mantenimiento de autoservicio para aplicar actualizaciones a tus entornos que no son de producción según el cronograma especificado.

Configura un período de mantenimiento en un clúster de producción

Para tu clúster de producción, es importante programar un período de mantenimiento. Esto te permite controlar cuándo se producen las actualizaciones y alinearlas con los períodos de poco tráfico de tu empresa.

Establece un período de mantenimiento en el clúster de producción

Programa un período de mantenimiento para tu clúster de producción. Elige un día y una hora en que tu sistema de producción experimente la carga más baja. El tiempo total requerido para un solo evento de mantenimiento puede variar.

AlloyDB retrasa automáticamente las actualizaciones de tu clúster de producción durante al menos una semana después de actualizar tu clúster de etapa de pruebas. Si encuentras problemas después de que se actualiza el clúster de etapa de pruebas, puedes rechazar las actualizaciones de mantenimiento de producción por hasta 30 días y trabajar con el equipo de asistencia para resolver los problemas.Google Cloud

Establece un período de mantenimiento en tu clúster de producción de la siguiente manera:

Console

  1. Ve a la página Clústeres.

    Ir a los clústeres

  2. Haz clic en un clúster en la columna Nombre del recurso.

  3. En la página Descripción general, en la sección Mantenimiento, haz clic en Editar. Se abrirá una ventana de configuración.

  4. En la sección Período de mantenimiento preferido, selecciona el día de la semana para este período de mantenimiento. La opción predeterminada es "Cualquier período".

    Cuando creas un clúster, AlloyDB le asigna este período de mantenimiento predeterminado.

  5. Si seleccionas un día para las actualizaciones de mantenimiento, selecciona la hora del día para el período de mantenimiento.

  6. Haz clic en Actualizar para guardar los cambios.

gcloud

Para usar gcloud CLI, puedes instalar y, luego, inicializar Google Cloud CLI, o bien puedes usar Cloud Shell.

Para recuperar los detalles de configuración de un clúster de AlloyDB, ejecuta lo siguiente con el gcloud alloydb clusters update comando.

gcloud alloydb clusters update PRODUCTION_CLUSTER_ID \
    --region=LOCATION_ID \
    --maintenance-window-day=DAY_OF_WEEK \
    --maintenance-window-hour=HOUR_OF_DAY \
    --project=PROJECT_ID

Realiza los siguientes reemplazos:

  • PRODUCTION_CLUSTER_ID: Es el ID de tu clúster de producción.
  • LOCATION_ID: la Google Cloud región.
  • DAY_OF_WEEK: Es el día preferido para el mantenimiento, como SUNDAY.

  • HOUR_OF_DAY: Es la hora preferida para el mantenimiento en UTC (0-23).

    En el siguiente ejemplo, se muestra cómo establecer el período de mantenimiento para los domingos a las 2 a.m. UTC:

    gcloud alloydb clusters update my-prod-cluster \
    --region=us-central1 \
    --maintenance-window-day=SUNDAY \
    --maintenance-window-hour=2 \
    --project=my-production-project

Verifica el período de mantenimiento en el clúster de producción

Para confirmar que el período de mantenimiento esté establecido para tu clúster de producción, ejecuta el gcloud alloydb clusters describe comando:

gcloud alloydb clusters describe PRODUCTION_CLUSTER_ID \
--region=LOCATION_ID \
--project=PROJECT_ID

El resultado muestra el campo maintenanceSchedule con el día y la hora de mantenimiento especificados.

Habilita las notificaciones de mantenimiento

Te recomendamos que habilites la opción para recibir notificaciones sobre los eventos de mantenimiento programados para tu clúster de producción. Las notificaciones te ayudan a planificar cuándo comenzar las pruebas.

Para habilitar las notificaciones de mantenimiento, sigue estos pasos:

  1. Ve a la página Clústeres.

    Ir a los clústeres

  2. Haz clic en un clúster en la columna Nombre del recurso. Se abrirá la página Descripción general.

  3. En la página Descripción general, en la sección Mantenimiento, haz clic en Mostrar detalles para expandir la sección. Luego, haz clic en Editar en la fila Notificaciones. Se abrirá la página Comunicación.

  4. En la página Comunicación, selecciona la pestaña Comunicaciones del producto.

  5. En la fila de AlloyDB, en la columna Correo electrónico, activa el botón de notificación en Activado.

Después de configurar el período de mantenimiento para tu clúster de producción, AlloyDB lo actualiza a más tardar siete días después de la actualización del clúster de etapa de pruebas. Cuando eliges recibir notificaciones, recibes una notificación por correo electrónico que indica que se programó una actualización de mantenimiento para tu clúster de producción.

Actualizaciones del clúster de etapa de pruebas

Usa tu entorno de etapa de pruebas para validar la próxima actualización de producción.

Verifica el estado previo a la actualización

Como tu clúster de etapa de pruebas no tiene un período de mantenimiento, se encuentra entre los primeros clústeres en recibir la actualización. Sin embargo, AlloyDB no envía notificaciones para los clústeres que no están configurados con el período de mantenimiento. Aun así, puedes supervisar cuándo se producen las actualizaciones de mantenimiento con el Explorador de registros en la Google Cloud consola de.

  1. En la Google Cloud consola de, ve a la página Explorador de registros.

    Ir al Explorador de registros.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado con el subtítulo Logging.

  2. Selecciona Todos los recursos, elige tu clúster de etapa de pruebas y haz clic en Aplicar.

  3. Selecciona Todos los nombres de registro, selecciona maintenance_events y haz clic en Aplicar.

  4. En el panel Cronograma, selecciona el período en el que tu clúster de etapa de pruebas recibe actualizaciones.

Realiza la verificación funcional posterior a la actualización

Después de que AlloyDB actualice el clúster de etapa de pruebas, realiza pruebas funcionales para confirmar que las actualizaciones sean seguras y adecuadas para aplicar a tu entorno de producción.

Realiza la verificación del rendimiento posterior a la actualización

Verifica tu clúster de etapa de pruebas después de que finalice la actualización de mantenimiento. Evalúa cualquier impacto en el rendimiento de tu base de datos después de las actualizaciones del clúster de etapa de pruebas. Realiza pruebas funcionales y de rendimiento integrales para asegurarte de que tus aplicaciones se comporten como se espera y que cumplan con los ANS de rendimiento.

Para garantizar la estabilidad y el funcionamiento óptimo, haz lo siguiente:

  • Compara las líneas de base previas a la actualización con las métricas clave.
  • Ejecuta pruebas de carga para identificar regresiones.
  • Analiza el rendimiento de las consultas.
  • Supervisa el uso de recursos.

Toma medidas en función de los resultados de la verificación

Revisa los resultados de la verificación y realiza las siguientes acciones según los resultados:

  • La verificación se realiza correctamente: Si las pruebas funcionales y de rendimiento en el clúster de etapa de pruebas se realizan correctamente, significa que tu entorno de etapa de pruebas no tiene errores y que puedes permitir que el mantenimiento de producción continúe según lo programado en su período programado. Prepárate para la actualización de producción y comunica a los interesados pertinentes.
  • La verificación falla: Si las pruebas funcionales y de rendimiento en el clúster de etapa de pruebas fallan y encuentras errores funcionales, degradaciones del rendimiento o un comportamiento inesperado en tu entorno de etapa de pruebas después de la actualización de mantenimiento, debes rechazar el mantenimiento de producción.

Rechaza un evento de mantenimiento programado

Para rechazar un evento de mantenimiento programado para tu clúster de producción, debes establecer la fecha de inicio, la fecha de finalización y la hora del día en que comienza y termina el intervalo.

Las fechas de inicio y finalización deben tener el siguiente formato: YYYY-MM-DD. La fecha y la hora de inicio y finalización están en la zona horaria UTC.

Para usar gcloud CLI, puedes instalar y, luego, inicializar Google Cloud CLI, o bien puedes usar Cloud Shell.

Para agregar un período de rechazo del mantenimiento a un clúster de AlloyDB, completa los siguientes pasos:

  1. Ejecuta el gcloud alloydb clusters update comando con las marcas deny-maintenance-period-start-date, deny-maintenance-period-end-date y deny-maintenance-period-time:

    gcloud alloydb clusters update CLUSTER_ID \
    --region LOCATION_ID \
    --deny-maintenance-period-start-date START_DATE \
    --deny-maintenance-period-end-date END_DATE \
    --deny-maintenance-period-time TIME

  2. Reemplaza lo siguiente:

    • CLUSTER_ID: Es el clúster que se configurará para el período sin mantenimiento.
    • LOCATION_ID: Laregión en la que se encuentra este clúster, por ejemplo, us-central1. Google Cloud
    • START_DATE: Es la fecha de inicio del período sin mantenimiento en formato UTC YYYY-MM-DD.
    • END_DATE: Es el final del período sin mantenimiento en formato UTC YYYY-MM-DD.
    • TIME: Es la hora del período sin mantenimiento en formato UTC HH:MM. Las horas se representan en el formato de las 24 horas, en el que los valores varían de 00:00 a 23:59, por ejemplo, 16:45.

  3. Documenta todos los problemas, incluidos los mensajes de error, las métricas de rendimiento y los pasos para reproducirlos.

  4. Abre un caso de asistencia de alta prioridad con Google Cloud y proporciona todos los problemas documentados. Google Cloud trabajará contigo para analizar y resolver los problemas.

Actualizaciones del clúster de producción

Si la verificación de etapa de pruebas se realiza correctamente y permites que continúe el mantenimiento de producción, las actualizaciones se producen durante el período de mantenimiento programado.

Verifica el período de mantenimiento

Para supervisar los próximos eventos de mantenimiento en tu clúster de producción, sigue estos pasos:

Console

  1. Ve a la página Clústeres.

    Ir a los clústeres

  2. Haz clic en un clúster en la columna Nombre del recurso. Se abrirá la página Descripción general.

  3. En la página Descripción general, en la sección Mantenimiento, consulta los detalles del período de mantenimiento de tu clúster.

    Google Cloud

  4. Opcional: En la página Estadísticas del sistema, puedes ver los detalles del estado de la operación de mantenimiento, como la Cronología de eventos.

  5. Para ver la administración de Mantenimiento unificado, ingresa "Mantenimiento de Cloud Hub" en la barra de búsqueda y selecciona Mantenimiento. En esta página, puedes ver un resumen de mantenimiento, el mantenimiento controlado por Google y los detalles del mantenimiento planificado.

gcloud

Para usar gcloud CLI, puedes instalar y, luego, inicializar Google Cloud CLI, o bien puedes usar Cloud Shell.

Ejecuta lo siguiente con gcloud alloydb clusters describe:

gcloud alloydb clusters describe PRODUCTION_CLUSTER_ID \
    --region=LOCATION_ID \
    --project=PROJECT_ID

Si se planea un evento de mantenimiento, el resultado incluye maintenanceSchedule y startTime. Si elegiste recibir notificaciones, también recibirás notificaciones por correo electrónico.

Supervisa la producción durante un período de mantenimiento

Si bien Google Cloud automatiza el proceso de mantenimiento, te recomendamos que supervises tu entorno de producción para lo siguiente durante el período de mantenimiento programado:

  • Estado de la aplicación: Supervisa los registros de la aplicación y las verificaciones de estado para detectar cualquier signo de interrupción.
  • Conectividad de la base de datos: Confirma que tus aplicaciones puedan volver a conectarse a la base de datos después de la interrupción.
  • Métricas de AlloyDB: Usa Google Cloud Monitoring para observar las métricas de AlloyDB (CPU, memoria, conexiones y retraso de replicación) y asegurarte de que vuelvan a los niveles esperados después de la actualización.

Verificación posterior a la actualización de mantenimiento

Una vez que se complete la actualización de mantenimiento, verifica tu entorno de producción para obtener indicadores críticos de funcionalidad y rendimiento.

  • Funcionalidad clave de la aplicación: Ejecuta una prueba de humo de las funciones más importantes de la aplicación.
  • Verificaciones básicas de rendimiento: Revisa los paneles para detectar aumentos repentinos en la latencia o el consumo de recursos.

¿Qué sigue?