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 del mantenimiento de autoservicio

Por lo general, AlloyDB aplica el mantenimiento a tus clústeres por ti, 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 del mantenimiento programado próximo. 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:

  • Tu clúster omitió el mantenimiento. Esto ocurre si configuras un período de rechazo o si tu clúster estaba en un 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.
  • Deseas ejecutar el mantenimiento en una cadencia personalizada o irregular. En este caso, puedes establecer un período de rechazo y, luego, realizar el mantenimiento de autoservicio cuando lo necesites. Los períodos de rechazo no bloquean el mantenimiento de autoservicio.

Granularidad 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 y completa el mantenimiento de cada instancia de forma independiente, por lo que es posible que las instancias estén en versiones diferentes. Por ejemplo, un clúster puede 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.

Visualiza la última versión disponible

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

Visualiza la versión actual de una instancia

Para usar gcloud CLI, puedes instalar y, luego, inicializar Google Cloud CLI o 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 gcloud alloydb instances describe comando:

    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 visualizas la versión.
    • CLUSTER_ID: Es el ID del clúster en el que se coloca la instancia.
    • LOCATION_ID: la Google Cloud región 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 última versión disponible

gcloud

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

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

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 obtener 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, haz 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 PATCH solicitud:

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?