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

Seleziona una versione della documentazione:

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

I passaggi da seguire 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.

Determinare 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. È lo stesso nome del cluster di database che hai dichiarato quando lo hai creato.

  • NAMESPACE: lo spazio dei nomi Kubernetes del tuo 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 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 cluster Kubernetes.

Se esegui una versione di AlloyDB Omni Operator precedente alla 1.0.0, segui le istruzioni riportate in Eseguire l'upgrade da una versione precedente alla 1.0.0 di AlloyDB Omni Operator.

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 successive, i passaggi successivi dipendono dalla versione di AlloyDB Omni a cui vuoi eseguire l'upgrade. Ciò, a sua volta, richiede la comprensione del numero di versione di AlloyDB Omni.

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

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 insieme al cluster di database. Ogni insieme di release di AlloyDB Omni che supportano una particolare versione secondaria di PostgreSQL ha un proprio numero di versione di AlloyDB Omni Operator, che puoi trovare nelle note di rilascio 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.

Esegui l'upgrade dell'operatore AlloyDB Omni

Kubernetes

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.1.0.

  2. Scarica l'ultima versione dell'operatore AlloyDB Omni:

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

  3. Applica le definizioni delle risorse personalizzate più recenti 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 loco per creare un nuovo cluster di database.

Se il tuo cluster AlloyDB Omni è stato creato con AlloyDB Omni Operator 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 esempio di manifest 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"
...