Gestionar las ventanas de mantenimiento de clústeres de AlloyDB para PostgreSQL

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

  • Definir, ver y borrar una ventana de mantenimiento.
  • Ver los próximos eventos de mantenimiento programados.
  • Configurar y eliminar un periodo de mantenimiento rechazado.

Todas las acciones que se indican 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 el artículo Información general sobre el mantenimiento.

Definir una ventana de mantenimiento en un clúster

Consola

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

    Ir a Clústeres

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

  3. En la página Resumen, en Mantenimiento, haz clic en Editar.

  4. En Ventana de mantenimiento, selecciona el día de la semana de esta ventana de mantenimiento.

    La opción predeterminada es Cualquier ventana. Cuando creas un clúster, se le asigna esta ventana de mantenimiento predeterminada.

  5. Selecciona la hora del día de esta ventana de mantenimiento.

  6. Haz clic en Actualizar para guardar los cambios.

gcloud

Para usar la CLI de gcloud, puedes instalar e inicializar Google Cloud CLI o usar Cloud Shell.

Para definir una ventana de mantenimiento en un clúster, ejecuta el comando gcloud clusters update 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

Haz los cambios siguientes:

  • CLUSTER_ID: el clúster en el que se va a definir la ventana de mantenimiento.

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

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

    El valor predeterminado es Cualquier ventana. Cuando creas un clúster, se le asigna esta ventana de mantenimiento predeterminada.

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

Si modificas el ajuste de la ventana de mantenimiento mientras el clúster ya está en mantenimiento o tiene programado un mantenimiento, los cambios no se aplicarán hasta que finalice el mantenimiento actual o programado.

Borrar una ventana de mantenimiento

Consola

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

    Ir a Clústeres

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

  3. En la página Resumen, en Mantenimiento, haz clic en Editar.

  4. En Ventana de mantenimiento, selecciona Cualquier ventana.

  5. Haz clic en Actualizar para guardar los cambios.

gcloud

Para usar la CLI de gcloud, puedes instalar e inicializar Google Cloud CLI o usar Cloud Shell.

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

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

Haz los cambios siguientes:

  • CLUSTER_ID: el clúster en el que se va a definir la ventana de mantenimiento.

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

Ver la ventana de mantenimiento de un clúster

Consola

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

    Ir a Clústeres

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

  3. En la página Resumen, en Mantenimiento, consulta los detalles de la ventana de mantenimiento de tu clúster.

gcloud

Para usar la CLI de gcloud, puedes instalar e inicializar Google Cloud CLI o usar Cloud Shell.

Para revisar la ventana de mantenimiento actual de un clúster, ejecuta el comando gcloud alloydb clusters describe:

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

Haz los cambios siguientes:

  • CLUSTER_ID: el clúster en el que se va a definir la ventana de mantenimiento.

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

Si el clúster tiene definida una ventana de mantenimiento, el resultado del comando incluirá 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 ninguna ventana de mantenimiento configurada.

Ver el próximo mantenimiento de un clúster

Consola

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

    Ir a Clústeres

  2. Busca tu clúster y consulta la columna Mantenimiento para obtener información sobre la próxima ventana de mantenimiento.

gcloud

Para usar la CLI de gcloud, puedes instalar e inicializar Google Cloud CLI o usar Cloud Shell.

Para ver el mantenimiento programado de un clúster que tiene una ventana de mantenimiento definida, ejecuta el comando gcloud clusters describe:

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

Haz los cambios siguientes:

  • CLUSTER_ID: el clúster en el que se va a definir la ventana de mantenimiento.

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

Si el clúster tiene un evento de mantenimiento programado en el futuro, el resultado del comando incluirá 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 tiene previsto empezar a actualizar el software del sistema de todos los nodos de este clúster.

Habilitar las notificaciones de mantenimiento

Las notificaciones de mantenimiento están inhabilitadas de forma predeterminada. Si decides habilitar las notificaciones por correo 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 antelación.
  • Las notificaciones de mantenimiento están habilitadas a nivel de proyecto. Google Cloud No puedes elegir recibir notificaciones sobre un subconjunto de clústeres de un proyecto.
  • Solo puedes habilitar las notificaciones para ti. Cada usuario debe habilitar esta opción por separado para recibir notificaciones de mantenimiento.

Para obtener más información, consulta el resumen del mantenimiento.

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

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

    Ir a Clústeres

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

  3. En la página Descripción general, en Mantenimiento, haz clic en Editar en la fila Notifications:.

  4. Haz clic en Comunicación.

  5. En la fila de AlloyDB, Ventana de mantenimiento, selecciona el interruptor de la columna Correo electrónico.

Configurar un periodo de mantenimiento denegado

Para evitar que se realicen operaciones de mantenimiento durante un periodo específico, puedes configurar un rechazo del periodo de mantenimiento. Puedes denegar el mantenimiento en un clúster que ejecute la versión más reciente de AlloyDB. El periodo de mantenimiento de rechazo puede durar entre 1 y 30 días.

Definir periodos de mantenimiento denegados

Para configurar un periodo de mantenimiento denegado, debes definir su fecha de inicio, su fecha de finalización y la hora del día en que empieza y termina el intervalo.

Las fechas de inicio y finalización deben tener el siguiente formato:

  • YYYY-MM-DD: indica una fecha concreta.

La fecha y la hora de inicio y finalización se indican en la zona horaria UTC.

gcloud

Para usar la CLI de gcloud, puedes instalar e inicializar Google Cloud CLI o usar Cloud Shell.

Para añadir un periodo de mantenimiento denegado a un clúster de AlloyDB, ejecuta el comando gcloud alloydb clusters update 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

Haz los cambios siguientes:

  • CLUSTER_ID: el clúster que se va a configurar para el periodo sin mantenimiento.
  • LOCATION_ID: la región en la que se encuentra este clúster. Por ejemplo, Google Cloud .us-central1
  • START_DATE: fecha de inicio del periodo sin mantenimiento en formato YYYY-MM-DD UTC.
  • END_DATE: el final del periodo sin mantenimiento en formato YYYY-MM-DD UTC.
  • TIME: hora del periodo sin mantenimiento en formato HH:MM UTC. Las horas se representan en formato de 24 horas, donde los valores van de 00:00 a 23:59 (por ejemplo, 16:45).

REST v1

En este ejemplo se añade un periodo de mantenimiento denegado a un clúster. Para ver la lista completa de parámetros de esta llamada, consulta Método: projects.locations.clusters.instances.patch.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

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

Para añadir un periodo de mantenimiento denegado, usa la siguiente solicitud PATCH:

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 indica a la API que actualice el campo denyMaintenancePeriods del bloque maintenanceUpdatePolicy.

El cuerpo JSON de la solicitud tiene el siguiente aspecto:

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

Rechazar el próximo mantenimiento

Los periodos de mantenimiento denegados tienen prioridad sobre el mantenimiento programado. Si se produce un conflicto de horarios, el periodo de mantenimiento rechazado anula la ventana de mantenimiento programada.

Si se establece un periodo de denegación que entra en conflicto con un evento de mantenimiento programado, no se cancelará inmediatamente el mantenimiento ni se borrará la programación. AlloyDB muestra el mantenimiento programado como próximo, pero cancela la ventana de mantenimiento programada cuando empieza la hora programada.

Para aplicar actualizaciones críticas, el sistema no suele permitir que se defina un periodo de denegación para saltarse más de un evento de mantenimiento y, en casos excepcionales, puede aplicar un mantenimiento de emergencia fuera de las preferencias de mantenimiento configuradas.

Quitar un periodo de mantenimiento denegado de un clúster

Puedes eliminar un periodo de mantenimiento denegado en cualquier momento.

gcloud

Para usar la CLI de gcloud, puedes instalar e inicializar Google Cloud CLI o usar Cloud Shell.

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

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

Haz los cambios siguientes:

  • CLUSTER_ID: el clúster del que se debe eliminar el periodo de mantenimiento rechazado.
  • LOCATION_ID: la región en la que se encuentra este clúster. Por ejemplo, Google Cloud .us-central1

REST v1

En este ejemplo se elimina un periodo de mantenimiento denegado de un clúster de AlloyDB. Para ver la lista completa de parámetros de esta llamada, consulta Método: projects.locations.clusters.patch.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • CLUSTER_ID: el ID del clúster al que añades un periodo de mantenimiento denegado.
  • PROJECT_ID: el ID del proyecto en el que se encuentra el clúster.
  • LOCATION_ID: la región en la que se encuentra este clúster. Por ejemplo, Google Cloud .us-central1

Para quitar un periodo de mantenimiento denegado, usa la siguiente solicitud PATCH:

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 indica a la API que actualice el campo denyMaintenancePeriods del bloque maintenanceUpdatePolicy.

El cuerpo JSON de la solicitud tiene el siguiente aspecto:

{}