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

Seleziona una versione della documentazione:

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

I passaggi da eseguire 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 attuali

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 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 installata sul 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 dell'operatore AlloyDB Omni precedente alla 1.0.0, segui le istruzioni riportate in Eseguire l'upgrade da un operatore AlloyDB Omni precedente alla versione 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 dell'operatore AlloyDB Omni 1.0.0 o successive, i passaggi successivi dipendono dalla versione di AlloyDB Omni a cui vuoi eseguire l'upgrade. A sua volta, ciò richiede la comprensione del numero di versione di AlloyDB Omni.

Il numero di versione di AlloyDB Omni ha i seguenti componenti:

  • Il numero di versione principale della compatibilità con PostgreSQL
  • Il numero di versione secondaria della compatibilità con PostgreSQL
  • Il numero di versione 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 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 secondaria di PostgreSQL ha il proprio numero di versione dell'operatore AlloyDB Omni, che puoi trovare in the release note per la 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 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 di 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

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 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 ha il seguente aspetto:

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