Esegui la migrazione all'ultima versione dell'operatore AlloyDB Omni Kubernetes

Seleziona una versione della documentazione:

Questa pagina descrive come eseguire l'upgrade dell'operatore AlloyDB Omni. I passaggi per eseguire l'upgrade di AlloyDB Omni in Kubernetes dipendono dalla versione attuale di AlloyDB Omni e dalla versione a cui esegui l'upgrade.

Determinare le versioni correnti

Per controllare la versione di AlloyDB Omni utilizzata dal cluster di database, esegui questo comando:

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentDatabaseVersion}'

Effettua le seguenti sostituzioni:

  • DB_CLUSTER_NAME: il nome del cluster di database. È lo stesso nome del cluster di database che hai dichiarato quando l'hai creato.

  • NAMESPACE: lo spazio dei nomi Kubernetes del cluster di database.

Se esegui la versione 1.0.0 o successive dell'operatore AlloyDB Omni, questo comando stampa la versione di AlloyDB Omni utilizzata dal cluster di database.

Per controllare la versione dell'operatore AlloyDB Omni installato sul tuo cluster Kubernetes, esegui questo comando:

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentControlPlaneAgentsVersion}'

Se esegui la versione 1.0.0 o successive dell'operatore AlloyDB Omni, l'output è il numero di versione dell'operatore AlloyDB Omni in esecuzione sul cluster Kubernetes.

Se esegui una versione dell'operatore AlloyDB Omni precedente alla versione 1.0.0, segui le istruzioni riportate in Eseguire l'upgrade da un operatore AlloyDB Omni precedente alla versione 1.0.0. Altrimenti, continua con Controlla i numeri di versione di destinazione.

Controllare i numeri di versione di destinazione

Se esegui una versione dell'operatore AlloyDB Omni 1.0.0 o successive, i passaggi successivi dipendono dalla versione di AlloyDB Omni a cui vuoi eseguire l'upgrade. Il numero di versione di AlloyDB Omni è composto dai seguenti componenti:

  • Il numero di versione principale della compatibilità con PostgreSQL
  • Il numero di versione secondaria della compatibilità con PostgreSQL
  • Il numero di versione della patch di questa release di AlloyDB Omni

Ad esempio, la versione 15.7.0 di AlloyDB Omni supporta la versione 15.7 di PostgreSQL e non ha una patch di rilascio di AlloyDB Omni.

Scegli l'opzione di installazione adatta alla tua versione di destinazione:

Scenario di installazione Passaggi per l'aggiornamento
Vuoi eseguire l'upgrade a una versione di AlloyDB Omni che supporta una versione più recente di PostgreSQL. Esegui l'upgrade dell'operatore AlloyDB Omni e del cluster di database. Ogni insieme di release di AlloyDB Omni che supporta una versione secondaria specifica di PostgreSQL ha il proprio numero di versione dell'operatore AlloyDB Omni, che puoi trovare nelle note di rilascio per la versione di AlloyDB Omni. Utilizza la tabella di compatibilità delle versioni dell'operatore AlloyDB Omni per verificare che la versione dell'operatore AlloyDB Omni sia compatibile con la tua versione dell'operatore.
Vuoi eseguire l'upgrade solo a una versione patch più recente di AlloyDB Omni. Esegui l'upgrade solo del cluster di database. Prima di eseguire l'upgrade, controlla la tabella di compatibilità delle versioni dell'operatore AlloyDB Omni e le note di rilascio per determinare se devi aggiornare anche l'operatore AlloyDB Omni.
Tutti gli altri scenari Segui i passaggi descritti in Esegui l'upgrade dell'operatore AlloyDB Omni.

Esegui l'upgrade dell'operatore AlloyDB Omni

Per eseguire l'upgrade dell'operatore AlloyDB Omni:

  1. Definisci le variabili di ambiente:

    export GCS_BUCKET=alloydb-omni-operator
export OPERATOR_VERSION=OPERATOR_VERSION
export HELM_PATH=$OPERATOR_VERSION/alloydbomni-operator-$OPERATOR_VERSION.tgz

    Sostituisci OPERATOR_VERSION con la versione dell'operatore AlloyDB Omni a cui stai eseguendo l'upgrade, ad esempio 1.3.0.

  2. Scarica l'operatore AlloyDB Omni più recente:

    gcloud storage cp -r gs://$GCS_BUCKET/$HELM_PATH ./
tar -xvzf alloydbomni-operator-${OPERATOR_VERSION}.tgz

  3. Applica le definizioni delle risorse personalizzate dell'operatore AlloyDB Omni più recenti:

    kubectl apply -f alloydbomni-operator/crds

  4. Esegui l'upgrade del grafico Helm dell'operatore AlloyDB Omni:

    helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--namespace alloydb-omni-system \
--atomic \
--timeout 5m

    Per aggiornare dbCluster, devi aggiornare le versioni di databaseVersion e controlPlaneAgentsVersion nel file manifest. Di seguito è riportata una parte di un file manifest che specifica la versione 15.7.0 di databaseVersion e la versione 1.3.0 di controlPlaneAgentsVersion:

    apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
name: DB_CLUSTER_NAME
spec:
databaseVersion: "15.7.0"
controlPlaneAgentsVersion: "1.3.0"
...