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:

  • Configurar, ver y borrar un período de mantenimiento
  • Consulta los próximos eventos de mantenimiento programados.
  • Configurar y quitar un rechazo del período de mantenimiento

Todas las acciones mencionadas 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.

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 ventana. 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 bien usar Cloud Shell.

Para establecer un período 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

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el clúster en el que se establecerá 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.

  • 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 ventana. 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 bien usar Cloud Shell.

Para borrar el período 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

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el clúster en el que se establecerá 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, consulta 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 bien usar Cloud Shell.

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

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el clúster en el que se establecerá 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 establecida una ventana de mantenimiento, 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, el clúster no tiene un período de mantenimiento establecido.

Cómo ver 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 bien usar Cloud Shell.

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

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el clúster en el que se establecerá 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 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 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 habilitar la opción para 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 a nivel del proyecto Google Cloud . 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 por correo electrónico automatizada cada vez que se programe o cancele un evento de mantenimiento para un clúster que tenga establecido un período de mantenimiento, sigue estos pasos con la consola de Google Cloud :

  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 en la fila Notifications:.

  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 rechazo del período de mantenimiento

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

Cómo establecer rechazos del período de mantenimiento

Para configurar un período de rechazo del mantenimiento, debes establecer su fecha de inicio, su 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 hora de inicio y finalización se encuentran en la zona horaria UTC.

gcloud

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

Para agregar un período de rechazo del mantenimiento 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

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 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 denegación a un clúster existente. Para ver una lista completa de los parámetros de esta llamada, consulta Method: projects.locations.clusters.instances.patch.

Antes de usar cualquiera de los datos de 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 el formato YYYY.
  • START_MONTH: Es el mes en el que comienza el período sin mantenimiento en formato MM. El cero inicial para los meses de un solo dígito es opcional. Por ejemplo, tanto 2 como 02 son válidos para febrero.
  • START_DAY: Es el día en que comienza el período sin mantenimiento en formato DD. El cero inicial para 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: Es el año en el que finaliza el período sin mantenimiento en formato YYYY.
  • END_MONTH: Es el mes en el 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): Hora del período sin mantenimiento en formato de 24 horas, por ejemplo, 16. El cero inicial para las horas de un solo dígito es opcional. Por ejemplo, tanto 2 como 02 son válidos.
  • MINUTE(S): Es el minuto del período sin mantenimiento que acepta valores de 0 a 59, por ejemplo, 45. El cero inicial para los minutos de un solo dígito es opcional: 7 y 07 son válidos.

Para agregar un rechazo del período de mantenimiento, 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 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 rechazo del mantenimiento tienen prioridad sobre el mantenimiento programado. Si se produce un conflicto de tiempo, el período de rechazo del mantenimiento anula el período de mantenimiento programado.

Si se establece un período de rechazo que entra en conflicto con un evento de mantenimiento programado, no se cancelará de inmediato el mantenimiento ni se borrará 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 críticas, el sistema no suele permitir establecer 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 rechazo del período de mantenimiento de un clúster

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

gcloud

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

Para quitar un período de mantenimiento de denegación 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

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el clúster del que se quitará el período de rechazo del mantenimiento.
  • 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 rechazado 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 solicitud, realiza los siguientes reemplazos:

  • CLUSTER_ID: Es el ID del clúster al que agregas un período de mantenimiento denegado.
  • 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 rechazo del mantenimiento, 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 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:

{}