Realiza el mantenimiento de autoservicio

Puedes realizar el mantenimiento de autoservicio si necesitas aplicar las actualizaciones más recientes de AlloyDB para PostgreSQL a tus clústeres lo antes posible. Actualizar a la versión más reciente puede desbloquear funciones de AlloyDB, aplicar parches y permitirte establecer un período de rechazo para evitar interrupciones durante períodos sensibles.

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

Casos de uso de mantenimiento automático

Por lo general, AlloyDB aplica el mantenimiento a tus clústeres, y realiza 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 atención regional. De manera opcional, puedes establecer un período de mantenimiento para definir un horario de mantenimiento programado preferido y recibir notificaciones sobre el próximo mantenimiento programado. Para una versión y una versión de PostgreSQL determinadas, el mantenimiento se completa primero para los clústeres sin períodos de mantenimiento y, luego, se programa para los clústeres con períodos de mantenimiento.

Puedes decidir realizar el mantenimiento de autoservicio por los siguientes motivos:

  • Se omitió el mantenimiento de tu clúster. Esto ocurre si configuras un período de rechazo 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 establecer un período de rechazo en un clúster que no esté actualizado. Los clústeres con instancias en versiones anteriores no siempre admiten la configuración de períodos de rechazo.
  • Quieres ejecutar el mantenimiento con una cadencia personalizada o irregular. En este caso, puedes establecer un período de denegación y, luego, realizar el mantenimiento de autoservicio cuando lo necesites. Los períodos de rechazo no bloquean el mantenimiento de autoservicio.

Nivel de detalle de los recursos durante las actualizaciones

AlloyDB solo admite el mantenimiento a nivel del clúster. Dentro del clúster, AlloyDB determina el orden de las actualizaciones de instancias. AlloyDB intenta completar el mantenimiento de cada instancia de forma independiente, por lo que es posible que las instancias tengan diferentes versiones. Por ejemplo, un clúster podría omitir el mantenimiento en las instancias existentes debido a un período de rechazo y, luego, crear una instancia en la versión más reciente.

Cómo ver la última versión disponible

Consulta los registros de cambios de mantenimiento de AlloyDB para conocer la versión más reciente. El registro de cambios se actualiza después de que se aplica 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.

Cómo ver la versión actual de una instancia

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

La visualización de la versión solo se admite a nivel de la 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

    Reemplaza lo siguiente:

    • INSTANCE_ID: Es el ID de la instancia para la que ves la versión.
    • CLUSTER_ID: Es el ID del clúster en el que se coloca la instancia.
    • LOCATION_ID: Es 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"

Actualiza el clúster a la versión más reciente disponible

gcloud

Para usar gcloud CLI, puedes instalar y, luego, inicializar Google Cloud CLI, o bien 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

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el ID del clúster que se actualizará a la versión más reciente.
  • LOCATION_ID: Es la Google Cloud región 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 este clúster a la versión más reciente. Para ver una lista completa de los parámetros de esta llamada, consulta Method: projects.locations.clusters.patch.

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

  • CLUSTER_ID: Es el clúster que se actualizará a la versión más reciente.
  • 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 actualizar tu clúster a la versión más reciente, usa la siguiente solicitud de 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 actualizarán las instancias del clúster.

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

{
  "maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}

¿Qué sigue?