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

Questa pagina illustra le istruzioni per l'upgrade dalla versione 1.0.0 alla versione 1.1.0 dell'operatore AlloyDB Omni.

I passaggi per eseguire l'upgrade di AlloyDB Omni in Kubernetes dipendono dalla versione di AlloyDB Omni in esecuzione e dalla versione a cui esegui l'upgrade.

Determina i numeri di versione correnti

Kubernetes

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}'

Sostituisci quanto segue:

  • DB_CLUSTER_NAME: il nome del cluster di database. Si tratta dello stesso nome del cluster di database dichiarato quando lo hai creato.

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

Se esegui la versione 1.0.0 o successiva dell'operatore AlloyDB Omni, questo comando stampa la versione di AlloyDB Omni utilizzata dal tuo 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, questo comando stampa il numero di versione dell'operatore AlloyDB Omni in esecuzione sul tuo cluster Kubernetes.

Se esegui una versione di AlloyDB Omni Operator 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 alla sezione Controllare i numeri di versione di destinazione.

Controllare i numeri di versione di destinazione

Kubernetes

Se esegui una versione di AlloyDB Omni Operator 1.0.0 o successiva, i passaggi successivi dipendono dalla versione di AlloyDB Omni a cui vuoi eseguire l'upgrade. Questo, a sua volta, richiede la conoscenza del numero di versione di AlloyDB Omni.

Il numero di versione di AlloyDB Omni è composto 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.5.5 di AlloyDB Omni è la versione della patch 5 di AlloyDB Omni che supporta la versione 15.5 di PostgreSQL.

Se vuoi eseguire l'upgrade a una versione di AlloyDB Omni che supporta una versione più recente di PostgreSQL, devi eseguire l'upgrade dell'operatore AlloyDB Omni stesso, insieme al cluster di database. Ogni insieme di release di AlloyDB Omni che supporta una determinata versione minore di PostgreSQL ha il proprio numero di versione di AlloyDB Omni Operator, che puoi trovare nella release note della versione di AlloyDB Omni.

Se vuoi eseguire l'upgrade solo a una versione patch più recente di AlloyDB Omni, puoi eseguire l'upgrade solo del cluster di database, senza dover eseguire l'upgrade dell'operatore AlloyDB Omni stesso.

In caso contrario, vai alla sezione Eseguire l'upgrade dell'operatore AlloyDB Omni.

Eseguire l'upgrade dell'operatore AlloyDB Omni

Kubernetes

Per eseguire l'upgrade dell'operatore Omni di AlloyDB:

  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.1.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 definizioni più recenti delle 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

Dopo aver completato l'upgrade dell'operatore AlloyDB Omni, segui le istruzioni riportate in Eseguire un upgrade in situ per creare un nuovo cluster di database.

Se il cluster AlloyDB Omni è stato creato con l'operatore AlloyDB Omni 1.0.0, aggiungi il campo controlPlaneAgentsVersion al manifest e impostalo su 1.1.0 prima di eseguire l'upgrade del cluster alla versione 15.5.5. In caso contrario, viene visualizzato il seguente errore:

admission webhook "vdbcluster.alloydbomni.dbadmin.goog" denied the request: unsupported database version 15.5.5 and/or control plane agents version 1.0.0

Un manifest di esempio con il campo controlPlaneAgentsVersion è il seguente:

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