Administra los períodos de mantenimiento de los clústeres de AlloyDB para PostgreSQL

En esta página, se muestra cómo realizar las siguientes acciones relacionadas con el mantenimiento del clúster de AlloyDB para PostgreSQL:

  • Configura, visualiza y borra un período de mantenimiento.
  • Visualiza los próximos eventos de mantenimiento programados.
  • Configura y quita un período de mantenimiento de rechazo.

Todas las acciones enumeradas se aplican a los clústeres principales y secundarios.

Para obtener una descripción general de cómo funciona el mantenimiento con los clústeres de AlloyDB, consulta Descripción general del mantenimiento. También puedes aprender a administrar las actualizaciones de mantenimiento de AlloyDB con un clúster de etapa de pruebas.

Configura un período de mantenimiento en un clúster

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 Mantenimiento, haz clic en Editar.

  4. En Período de mantenimiento, 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, se le asigna este período de mantenimiento predeterminado.

  5. Selecciona la hora del día para este 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 usar Cloud Shell.

Para configurar un período de mantenimiento en un clúster, ejecuta gcloud alloydb clusters update

comando con las marcas --maintenance-window-day y --maintenance-window-hour:

gcloud alloydb clusters update CLUSTER_ID \
  --region LOCATION_ID \
  --maintenance-window-day DAY_OF_WEEK \
  --maintenance-window-hour HOUR_OF_DAY

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el clúster en el que se configurará el período de mantenimiento.

  • LOCATION_ID: la Google Cloud región en la que se encuentra este clúster , por ejemplo, us-central1.

  • DAY_OF_WEEK: Es el día de la semana, en la zona horaria del Horario universal coordinado (UTC), para este período de mantenimiento. Los valores válidos son MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY y SUNDAY.

    El valor predeterminado es Cualquier período. Cuando creas un clúster, se le asigna este período de mantenimiento predeterminado.

  • HOUR_OF_DAY: Es un número entero entre 0 y 23 que representa la hora del día, en la zona horaria UTC, para este período de mantenimiento.

Si realizas cambios en la configuración del período de mantenimiento mientras el clúster ya está en mantenimiento o está programado para mantenimiento, los cambios no se aplicarán hasta que se complete el mantenimiento actual o programado.

Borra un período de mantenimiento

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 Mantenimiento, haz clic en Editar.

  4. En Período de mantenimiento, selecciona Cualquier período.

  5. Haz clic en Actualizar para guardar los cambios.

gcloud

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

Para borrar el período de mantenimiento de un clúster, ejecuta el gcloud clusters update comando con la --maintenance-window-any marca:

gcloud alloydb clusters update CLUSTER_ID \
  --region LOCATION_ID \
  --maintenance-window-any

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el clúster en el que se configurará el período de mantenimiento.

  • LOCATION_ID: Es la Google Cloud región en la que se encuentra este clúster, por ejemplo, us-central1.

Visualiza el período de mantenimiento de un clúster

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 Mantenimiento, visualiza los detalles del período de mantenimiento de tu clúster.

gcloud

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

Para revisar el período de mantenimiento actual en un clúster, ejecuta el gcloud alloydb clusters describe comando:

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el clúster en el que se configurará el período de mantenimiento.

  • LOCATION_ID: Es la Google Cloud región en la que se encuentra este clúster, por ejemplo, us-central1.

Si el clúster tiene un período de mantenimiento configurado, el resultado del comando incluye líneas similares a las siguientes:

maintenanceUpdatePolicy:
  maintenanceWindows:
  - day: TUESDAY
    startTime:
      hours: 23

Si el resultado no incluye una sección maintenanceUpdatePolicy, significa que el clúster no tiene un período de mantenimiento configurado.

Visualiza el próximo mantenimiento en un clúster

Console

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

    Ir a los clústeres

  2. Ubica tu clúster y consulta la columna Mantenimiento para obtener información sobre el próximo período de mantenimiento.

gcloud

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

Para ver el próximo mantenimiento planificado para un clúster que tiene un período de mantenimiento configurado, ejecuta el gcloud clusters describe comando:

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el clúster en el que se configurará el período de mantenimiento.

  • LOCATION_ID: Es la Google Cloud región en la que se encuentra este clúster, por ejemplo, us-central1.

Si el clúster tiene un evento de mantenimiento planificado en el futuro, el resultado del comando incluye líneas similares a las siguientes:

maintenanceSchedule:
  startTime: 2024-07-03T09:46:40Z

La marca de tiempo con formato UTC especifica el momento en el que AlloyDB planea comenzar a actualizar el software del sistema de todos los nodos de este clúster.

Habilita las notificaciones de mantenimiento

Las notificaciones de mantenimiento están inhabilitadas de forma predeterminada. Cuando elijas recibir notificaciones por correo electrónico sobre los próximos eventos de mantenimiento de AlloyDB, ten en cuenta lo siguiente:

  • Recibirás una notificación automática sobre el evento en cuanto se programe. Los eventos de mantenimiento se programan con al menos una semana de anticipación.
  • Las notificaciones de mantenimiento están habilitadas en el Google Cloud nivel del proyecto. No puedes elegir recibir notificaciones sobre un subconjunto de clústeres en un proyecto.
  • Solo puedes habilitar las notificaciones para ti. Cada usuario debe habilitar la opción por separado para recibir notificaciones de mantenimiento.

Para obtener más información, consulta Descripción general del mantenimiento.

Para recibir una notificación automática por correo electrónico cada vez que se programe o cancele un evento de mantenimiento para un clúster que tenga un período de mantenimiento configurado, sigue estos pasos con la Google Cloud consola:

  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 Mantenimiento, haz clic Editar en la Notifications: fila.

  4. Haz clic en Comunicación.

  5. En la fila de AlloyDB, Período de mantenimiento, selecciona el botón de activación en la columna Correo electrónico.

Configura un período de mantenimiento de rechazo

Para evitar las operaciones de mantenimiento durante un período específico, puedes configurar un período de mantenimiento de rechazo. Puedes configurar el rechazo de mantenimiento en un clúster que ejecute la versión más reciente de AlloyDB. Un período de mantenimiento de rechazo puede abarcar de uno a 30 días.

Los clústeres con instancias en versiones anteriores no siempre admiten la configuración de períodos de rechazo. Si necesitas configurar un período de rechazo en un clúster que no esté lo suficientemente actualizado, puedes realizar un mantenimiento de autoservicio para actualizar tu clúster.

Los períodos de rechazo existentes no bloquean el mantenimiento de autoservicio.

Configura períodos de mantenimiento de rechazo

Para configurar un período de mantenimiento de rechazo, configura 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: Indica una fecha específica.

La fecha y la hora de inicio y finalización están en la zona horaria UTC.

gcloud

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

Para agregar un período de mantenimiento de rechazo a un clúster de AlloyDB, 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

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el clúster que se configurará para el período sin mantenimiento.
  • LOCATION_ID: Es la Google Cloud región en la que se encuentra este clúster, por ejemplo, us-central1.
  • 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.

REST v1

En este ejemplo, se agrega un período de mantenimiento de rechazo a un clúster existente. Para ver una lista completa de los parámetros de esta llamada, consulta Método: projects.locations.clusters.instances.patch.

Antes de usar cualquiera de los datos de la solicitud, realiza los siguientes reemplazos:

  • CLUSTER_ID: Es el clúster que se configurará para el período sin mantenimiento.
  • PROJECT_ID: Es el ID del proyecto en el que se coloca el clúster.
  • LOCATION_ID: Es la Google Cloud región en la que se encuentra este clúster, por ejemplo, us-central1.
  • START_YEAR: Es el año en que comienza el período sin mantenimiento en formato YYYY.
  • START_MONTH: Es el mes en que comienza el período sin mantenimiento en formato MM. Un cero inicial para los meses de un solo dígito es opcional; por ejemplo, 2 y 02 son válidos para febrero.
  • START_DAY: Es el día en que comienza el período sin mantenimiento en formato DD. Un cero inicial para los días de un solo dígito es opcional; por ejemplo, 1 y 01 son válidos para el primer día del mes.
  • END_YEAR: Es el año en que finaliza el período sin mantenimiento en formato YYYY.
  • END_MONTH: Es el mes en que finaliza el período sin mantenimiento en formato MM.
  • END_DAY: Es el día en que finaliza el período sin mantenimiento en formato DD.
  • HOUR(S): Es la hora del período sin mantenimiento en formato de 24 horas, por ejemplo, 16. Un cero inicial para las horas de un solo dígito es opcional; por ejemplo, 2 y 02 son válidos.
  • MINUTE(S): Es el minuto del período sin mantenimiento que acepta valores de 0 a 59, por ejemplo, 45. Un cero inicial para los minutos de un solo dígito es opcional; 7 y 07 son válidos.

Para agregar un período de mantenimiento de rechazo, usa la siguiente PATCH solicitud:

PATCH https://alloydb.googleapis.com/v1/{cluster.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_update_policy.deny_maintenance_periods}

El parámetro de consulta maintenance_update_policy.deny_maintenance_periods le indica a la API que actualice el campo denyMaintenancePeriods dentro del bloque maintenanceUpdatePolicy.

El cuerpo JSON de la solicitud se ve de la siguiente manera:

"maintenanceUpdatePolicy": {
 "denyMaintenancePeriods": [
   {
     "startDate": {
       "year": START_YEAR,
       "month": START_MONTH,
       "day": START_DAY
     },
     "endDate": {
       "year": END_YEAR,
       "month": END_MONTH,
       "day": END_DAY
     },
     "time": {
       "hours": TIME
       "minutes": TIME
     }
   }
 ]
},

Rechaza el próximo mantenimiento

Los períodos de mantenimiento de rechazo tienen prioridad sobre el mantenimiento programado. Si se produce un conflicto de tiempo, el período de mantenimiento de rechazo anula el período de mantenimiento programado.

Configurar un período de rechazo que entre en conflicto con un evento de mantenimiento programado no cancela de inmediato el mantenimiento ni borra la programación. AlloyDB muestra el mantenimiento programado existente como próximo, pero cancela el período de mantenimiento programado cuando comienza la hora programada.

Para ayudar a aplicar actualizaciones importantes, el sistema no suele permitir configurar un período de rechazo para omitir más de un evento de mantenimiento y, en casos excepcionales, puede aplicar mantenimiento de emergencia fuera de las preferencias de mantenimiento configuradas.

Quita un período de mantenimiento de rechazo de un clúster

Puedes quitar un período de mantenimiento de rechazo en cualquier momento.

gcloud

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

Para quitar un período de mantenimiento de rechazo de un clúster de AlloyDB, ejecuta el gcloud alloydb clusters update comando con la marca remove-deny-maintenance-period:

gcloud alloydb clusters update CLUSTER_ID --region LOCATION_ID  --remove-deny-maintenance-period

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el clúster del que se quitará el período de mantenimiento de rechazo.
  • LOCATION_ID: Es la Google Cloud región en la que se encuentra este clúster, por ejemplo, us-central1.

REST v1

En este ejemplo, se quita un período de mantenimiento de rechazo de un clúster de AlloyDB. Para ver una lista completa de los parámetros de esta llamada, consulta Método: projects.locations.clusters.patch.

Antes de usar cualquiera de los datos de la solicitud, realiza los siguientes reemplazos:

  • CLUSTER_ID: Es el ID del clúster al que le agregas un período de mantenimiento de rechazo.
  • PROJECT_ID: Es el ID del proyecto en el que se coloca el clúster.
  • LOCATION_ID: Es la Google Cloud región en la que se encuentra este clúster, por ejemplo, us-central1.

Para quitar un período de mantenimiento de rechazo, usa la siguiente PATCH solicitud:

PATCH https://alloydb.googleapis.com/v1/{cluster.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_update_policy.deny_maintenance_periods}

El parámetro de consulta maintenance_update_policy.deny_maintenance_periods le indica a la API que actualice el campo denyMaintenancePeriods dentro del bloque maintenanceUpdatePolicy.

El cuerpo JSON de la solicitud se ve de la siguiente manera:

{}

¿Qué sigue?