Eseguire la manutenzione self-service

Puoi eseguire la manutenzione self-service se devi applicare gli ultimi aggiornamenti di AlloyDB for PostgreSQL ai tuoi cluster il prima possibile. L'aggiornamento all'ultima versione può sbloccare le funzionalità di AlloyDB, applicare patch e consentirti di impostare un periodo di negazione per evitare interruzioni durante i periodi di tempo sensibili.

Per saperne di più, consulta la Panoramica della manutenzione.

Casi d'uso per l'automantenimento

In genere AlloyDB applica la manutenzione ai tuoi cluster, eseguendo operazioni di manutenzione per aggiornare il software del database nei cluster. Per impostazione predefinita, AlloyDB esegue la manutenzione al di fuori dell'orario di lavoro regionale. Se vuoi, puoi impostare un periodo di manutenzione per definire un orario di manutenzione pianificata preferito e ricevere notifiche della manutenzione pianificata imminente. Per una determinata release e versione di PostgreSQL, la manutenzione viene completata prima per i cluster senza finestre di manutenzione, poi pianificata per i cluster con finestre di manutenzione.

Potresti decidere di eseguire la manutenzione self-service per i seguenti motivi:

  • La manutenzione del cluster è stata ignorata. Ciò si verifica se hai configurato un periodo di rifiuto o se il cluster era in stato di bootstrapping durante la migrazione.
  • Il cluster richiede un aggiornamento prima che venga eseguita la manutenzione pianificata.
  • Devi impostare un periodo di rifiuto su un cluster non aggiornato. I cluster con istanze nelle versioni precedenti non sempre supportano l'impostazione di periodi di negazione.
  • Vuoi eseguire la manutenzione con una cadenza personalizzata o irregolare. In questo caso, puoi impostare un periodo di rifiuto ed eseguire la manutenzione self-service quando ne hai bisogno. I periodi in cui evitare la manutenzione non bloccano la manutenzione self-service.

Granularità delle risorse durante gli aggiornamenti

AlloyDB supporta la manutenzione solo a livello di cluster. All'interno del cluster, AlloyDB determina l'ordine degli aggiornamenti delle istanze. AlloyDB tenta e completa la manutenzione per ogni istanza in modo indipendente, quindi è possibile che le istanze si trovino su versioni diverse. Ad esempio, un cluster potrebbe saltare la manutenzione delle istanze esistenti a causa di un periodo di negazione e poi creare un'istanza nell'ultima versione.

Visualizzare l'ultima versione disponibile

Consulta i changelog della manutenzione di AlloyDB per l'ultima versione. Il log delle modifiche viene aggiornato dopo l'applicazione della manutenzione ai cluster in tutte le regioni. Per saperne di più su come vengono applicate le versioni più recenti alle regioni, vedi Versione più recente.

Visualizzare la versione corrente di un'istanza

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

La visualizzazione della versione è supportata solo a livello di istanza.

  1. Per visualizzare la versione di manutenzione attuale dell'istanza, esegui il comando gcloud alloydb instances describe:

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

    Sostituisci quanto segue:

    • INSTANCE_ID: l'ID dell'istanza per cui stai visualizzando la versione.
    • CLUSTER_ID: l'ID del cluster in cui si trova l'istanza.
    • LOCATION_ID: la regione Google Cloud in cui si trova questo cluster, ad esempio us-central1.

  2. Nella risposta, trova il campo maintenanceVersionName per vedere la versione in esecuzione dell'istanza. Ad esempio:

    "maintenanceVersionName": "POSTGRES_16.20251015.04_00"

Aggiorna il cluster all'ultima versione disponibile

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

Per aggiornare il cluster all'ultima versione, esegui il comando gcloud alloydb clusters update con il flag maintenance-version:

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

Sostituisci quanto segue:

  • CLUSTER_ID: l'ID del cluster da aggiornare all'ultima versione.
  • LOCATION_ID: la regione Google Cloud in cui si trova questo cluster, ad esempio us-central1.

Esempio di risposta:

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

REST v1

Questo esempio aggiorna il cluster all'ultima versione. Per un elenco completo dei parametri per questa chiamata, consulta Metodo: projects.locations.clusters.patch.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • CLUSTER_ID: il cluster da aggiornare all'ultima versione.
  • PROJECT_ID: l'ID del progetto in cui si trova il cluster.
  • LOCATION_ID: la regione Google Cloud in cui si trova questo cluster, ad esempio us-central1.

Per aggiornare il cluster all'ultima versione, utilizza la seguente richiesta PATCH:

PATCH https://alloydb.googleapis.com/v1/{cluster.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_version_selection_policy}

Il parametro di query maintenance_version_selection_policy specifica la versione a cui aggiornare le istanze del cluster.

Il corpo JSON della richiesta ha il seguente aspetto:

{
  "maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}

Passaggi successivi