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

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 corrente di AlloyDB Omni e dalla versione a cui esegui l'upgrade.

Determina le tue versioni correnti

Per verificare la versione di AlloyDB Omni utilizzata dal tuo cluster di database, esegui il seguente comando:

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

Esegui le seguenti sostituzioni:

  • DB_CLUSTER_NAME: il nome del cluster di database. Si tratta dello stesso nome del cluster di database dichiarato al momento della creazione.

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

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

Per controllare la versione dell'operatore AlloyDB Omni installato sul tuo cluster Kubernetes, esegui il seguente 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, il risultato è il numero di versione dell'operatore AlloyDB Omni in esecuzione sul tuo cluster Kubernetes.

Se esegui una versione dell'operatore AlloyDB Omni precedente alla 1.0.0, segui le istruzioni riportate in Eseguire l'upgrade da un operatore AlloyDB Omni precedente alla 1.0.0. In caso contrario, vai a Controllare 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 successiva, i passaggi successivi dipendono dalla versione di AlloyDB Omni a cui vuoi eseguire l'upgrade. Il numero di versione di AlloyDB Omni è costituito dai seguenti componenti:

  • Il numero della versione principale della compatibilità con PostgreSQL
  • Il numero della 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 set di release di AlloyDB Omni che supporta una versione minore PostgreSQL specifica ha il proprio numero di versione dell'operatore AlloyDB Omni, che puoi trovare nella release note della versione di AlloyDB Omni. Utilizza la tabella di compatibilità delle versioni degli operatori 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 del database. Prima di eseguire l'upgrade, consulta la tabella di compatibilità delle versioni degli operatori 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 Eseguire l'upgrade dell'operatore AlloyDB Omni.

Eseguire 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.2.0.

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

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

  3. Applica le ultime definizioni di risorse personalizzate dell'operatore AlloyDB Omni:

    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 databaseVersion e controlPlaneAgentsVersion nel file manifest. Di seguito è riportato parte di un file manifest che specifica la versione 15.7.0 di databaseVersion e la versione 1.2.0 di controlPlaneAgentsVersion:

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