Realizar el mantenimiento de autoservicio

Puedes realizar el mantenimiento por tu cuenta si necesitas aplicar las últimas actualizaciones de AlloyDB para PostgreSQL a tus clústeres lo antes posible. Si actualizas a la versión más reciente, podrás desbloquear funciones de AlloyDB, aplicar parches y establecer un periodo de denegación para evitar interrupciones durante periodos sensibles.

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

Casos prácticos de automantenimiento

AlloyDB suele aplicar el mantenimiento a tus clústeres, realizando operaciones de mantenimiento para actualizar el software de la base de datos en los clústeres. De forma predeterminada, AlloyDB realiza el mantenimiento fuera del horario de apertura de la región. También puedes definir una ventana de mantenimiento para especificar la hora de mantenimiento programado que prefieras y recibir notificaciones sobre el mantenimiento programado que vaya a tener lugar próximamente. En una versión y una versión de PostgreSQL concretas, el mantenimiento se completa primero en los clústeres sin ventanas de mantenimiento y, después, se programa para los clústeres con ventanas de mantenimiento.

Puede que decidas realizar el mantenimiento de autoservicio por los siguientes motivos:

  • Tu clúster se ha saltado el mantenimiento. Esto ocurre si has configurado un periodo de denegación o si tu clúster estaba en estado de arranque durante la migración.
  • Tu clúster requiere una actualización antes de que se realice el mantenimiento programado.
  • Debes definir un periodo de denegación en un clúster que no esté actualizado. Los clústeres con instancias en versiones anteriores no siempre admiten la configuración de deny periods.
  • Quieres realizar el mantenimiento con una cadencia personalizada o irregular. En este caso, puedes definir un periodo de rechazo y, después, realizar el mantenimiento por tu cuenta cuando lo necesites. Los periodos de rechazo no bloquean el mantenimiento de autoservicio.

Granularidad de los recursos durante las actualizaciones

AlloyDB solo admite el mantenimiento a nivel de clúster. Dentro del clúster, AlloyDB determina el orden de las actualizaciones de las instancias. AlloyDB intenta y completa el mantenimiento de cada instancia de forma independiente, por lo que es posible que las instancias tengan versiones diferentes. Por ejemplo, un clúster puede saltarse el mantenimiento de las instancias existentes debido a un periodo de denegación y, después, crear una instancia en la versión más reciente.

Ver la última versión disponible

Consulta los registros de cambios del mantenimiento de AlloyDB para ver la versión más reciente. El registro de cambios se actualiza después de que se aplique el mantenimiento a los clústeres de todas las regiones. Para obtener más información sobre cómo se aplican las versiones más recientes a las regiones, consulta Versión más reciente.

Ver la versión actual de una instancia

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

Solo se puede ver la versión a nivel de instancia.

  1. Para ver la versión de mantenimiento actual de la instancia, ejecuta el comando gcloud alloydb instances describe:

    gcloud alloydb instances describe INSTANCE_ID \
--cluster CLUSTER_ID \
--region LOCATION_ID

    Haz los cambios siguientes:

    • INSTANCE_ID: el ID de la instancia cuya versión estás viendo.
    • CLUSTER_ID: el ID del clúster en el que se coloca la instancia.
    • LOCATION_ID: la región Google Cloud en la que se encuentra este clúster (por ejemplo, us-central1).

  2. En la respuesta, busca el campo maintenanceVersionName para ver la versión que ejecuta la instancia. Por ejemplo:

    "maintenanceVersionName": "POSTGRES_16.20251015.04_00"

Actualizar el clúster a la última versión disponible

gcloud

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

Para actualizar el clúster a la versión más reciente, ejecuta el comando gcloud alloydb clusters update con la marca maintenance-version:

gcloud alloydb clusters update CLUSTER_ID \
--region LOCATION_ID \
--maintenance-version=latest

Haz los cambios siguientes:

  • CLUSTER_ID: el ID del clúster que se va a actualizar a la versión más reciente.
  • LOCATION_ID: la región Google Cloud en la que se encuentra este clúster (por ejemplo, us-central1).

Respuesta de ejemplo:

Operation ID: operation-1746645915198-63490b152e3c8-2aed1bd1-3fd73867
Updating cluster...done.

REST v1

En este ejemplo, se actualiza el clúster a la versión más reciente. Para ver la lista completa de parámetros de esta llamada, consulta Method: projects.locations.clusters.patch.

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

  • CLUSTER_ID: el clúster que se va a actualizar a la versión más reciente.
  • PROJECT_ID: el ID del proyecto en el que se encuentra el clúster.
  • LOCATION_ID: la región Google Cloud en la que se encuentra este clúster (por ejemplo, us-central1).

Para actualizar el clúster a la versión más reciente, 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_version_selection_policy}

El parámetro de consulta maintenance_version_selection_policy especifica la versión a la que se deben actualizar las instancias del clúster.

El cuerpo JSON de la solicitud tiene el siguiente aspecto:

{
  "maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}

Siguientes pasos