Zur neuesten Version des AlloyDB Omni Kubernetes-Operators migrieren

Wählen Sie eine Dokumentenversion aus:

Auf dieser Seite wird beschrieben, wie Sie ein Upgrade für den AlloyDB Omni-Operator durchführen. Die Schritte für das Upgrade von AlloyDB Omni in Kubernetes hängen von Ihrer aktuellen Version von AlloyDB Omni und der Version ab, auf die Sie das Upgrade durchführen.

Aktuelle Versionen ermitteln

Führen Sie den folgenden Befehl aus, um die Version von AlloyDB Omni zu prüfen, die von Ihrem Datenbankcluster verwendet wird:

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

Ersetzen Sie die folgenden Werte:

  • DB_CLUSTER_NAME: der Name Ihres Datenbankclusters. Das ist derselbe Datenbankclustername, den Sie beim Erstellen des Clusters angegeben haben .

  • NAMESPACE: Der Kubernetes-Namespace Ihres Datenbankclusters.

Wenn Sie Version 1.0.0 oder höher des AlloyDB Omni-Operators ausführen, wird mit diesem Befehl die Version von AlloyDB Omni ausgegeben, die von Ihrem Datenbankcluster verwendet wird.

Führen Sie den folgenden Befehl aus, um die Version des AlloyDB Omni-Operators zu prüfen, der in Ihrem Kubernetes-Cluster installiert ist:

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

Wenn Sie Version 1.0.0 oder höher des AlloyDB Omni-Operators ausführen, ist die Ausgabe die Versionsnummer des AlloyDB Omni-Operators, der in Ihrem Kubernetes-Cluster ausgeführt wird.

Wenn Sie eine Version des AlloyDB Omni-Operators vor 1.0.0 ausführen, folgen Sie der Anleitung unter Upgrade von einem AlloyDB Omni-Operator vor Version 1.0.0. Andernfalls fahren Sie mit Zielversionsnummern prüfen fort.

Zielversionsnummern prüfen

Wenn Sie eine Version des AlloyDB Omni-Operators 1.0.0 oder höher ausführen, hängen die nächsten Schritte von der Version von AlloyDB Omni ab, auf die Sie ein Upgrade durchführen möchten. Die AlloyDB Omni-Versionsnummer hat die folgenden Komponenten:

  • Die Hauptversionsnummer der PostgreSQL-Kompatibilität
  • Die Nebenversionsnummer der PostgreSQL-Kompatibilität
  • Die Patch-Versionsnummer dieser AlloyDB Omni-Version

Beispiel: AlloyDB Omni-Version 15.7.0 unterstützt PostgreSQL-Version 15.7 und hat keinen AlloyDB Omni-Release-Patch.

Wählen Sie die Installationsoption aus, die für Ihre Zielversion geeignet ist:

Installationsszenario Schritte für die Aktualisierung
Sie möchten auf eine Version von AlloyDB Omni aktualisieren, die eine neuere Version von PostgreSQL unterstützt. Führen Sie ein Upgrade des AlloyDB Omni-Operators und Ihres Datenbankclusters durch. Jede Gruppe von AlloyDB Omni-Releases, die eine bestimmte untergeordnete PostgreSQL-Nebenversion unterstützt, hat eine eigene AlloyDB Omni-Operatorversionsnummer. Diese finden Sie in den Versionshinweisen für die AlloyDB Omni-Version. Verwenden Sie die Kompatibilitätstabelle für AlloyDB Omni-Operatorversionen , um zu prüfen, ob Ihre AlloyDB Omni-Operatorversion mit Ihrer Operatorversion kompatibel ist.
Sie möchten nur ein Upgrade auf eine neuere Patch-Version von AlloyDB Omni durchführen. Führen Sie ein Upgrade nur für Ihren Datenbankcluster durch. Prüfen Sie vor dem Upgrade die Kompatibilitätstabelle für AlloyDB Omni-Operatorversionen und die Versionshinweise, um festzustellen, ob Sie auch den AlloyDB Omni-Operator aktualisieren müssen.
Alle anderen Szenarien Folgen Sie der Anleitung unter AlloyDB Omni-Operator aktualisieren.

AlloyDB Omni-Operator aktualisieren

So installieren Sie den AlloyDB Omni-Operator:

  1. Legen Sie die Umgebungsvariablen fest:

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

    Ersetzen Sie OPERATOR_VERSION durch die Version des AlloyDB Omni-Operators, auf die Sie aktualisieren, z. B. 1.3.0.

  2. Laden Sie den neuesten AlloyDB Omni-Operator herunter:

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

  3. Wenden Sie die neuesten benutzerdefinierten Ressourcendefinitionen des AlloyDB Omni-Operators an:

    kubectl apply -f alloydbomni-operator/crds

  4. Aktualisieren Sie das Helm-Diagramm für den AlloyDB Omni-Operator:

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

    Wenn Sie dbCluster aktualisieren möchten, müssen Sie die Versionen von databaseVersion und controlPlaneAgentsVersion in der Manifestdatei aktualisieren. Das Folgende ist Teil einer Manifestdatei, in der Version 15.7.0 von databaseVersion und Version 1.3.0 von controlPlaneAgentsVersion angegeben sind:

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