Zur neuesten Version des AlloyDB Omni Kubernetes-Operators migrieren

Auf dieser Seite finden Sie eine Anleitung zum Upgrade von Version 1.0.0 auf Version 1.1.0 des AlloyDB Omni-Betriebssystems.

Die Schritte zum Upgrade von AlloyDB Omni in Kubernetes hängen von der von Ihnen verwendeten AlloyDB Omni-Version und der Version ab, auf die Sie ein Upgrade durchführen.

Aktuelle Versionsnummern ermitteln

Kubernetes

Führen Sie diesen 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 Folgendes:

  • DB_CLUSTER_NAME: Der Name Ihres Datenbankclusters. Dies ist derselbe Name des Datenbankclusters, den Sie beim Erstellen angegeben haben.

  • NAMESPACE: den Kubernetes-Namespace Ihres Datenbankclusters.

Wenn Sie Version 1.0.0 oder höher des AlloyDB Omni-Betriebsmanagers 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-Betriebsmanagers 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-Betriebsmanagers ausführen, gibt dieser Befehl die Versionsnummer des AlloyDB Omni-Betriebsmanagers aus, der auf Ihrem Kubernetes-Cluster ausgeführt wird.

Wenn Sie eine Version des AlloyDB Omni-Betriebsmanagers vor 1.0.0 ausführen, folgen Sie der Anleitung unter Upgrade von einer Version des AlloyDB Omni-Betriebsmanagers vor 1.0.0.

Andernfalls fahren Sie mit dem Abschnitt Zielortnummern prüfen fort.

Zielversionsnummern prüfen

Kubernetes

Wenn Sie eine Version des AlloyDB Omni-Betriebsmanagers 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. Dazu ist es wiederum erforderlich, die AlloyDB Omni-Versionsnummer zu kennen.

Die AlloyDB Omni-Version besteht aus den folgenden Komponenten:

  • Die Hauptversionsnummer der PostgreSQL-Kompatibilität
  • Die Minorversion der PostgreSQL-Kompatibilität
  • Die Patchversion dieser AlloyDB Omni-Version

Beispiel: AlloyDB Omni Version 15.5.5 ist die Patchversion 5 von AlloyDB Omni, die PostgreSQL Version 15.5 unterstützt.

Wenn Sie auf eine Version von AlloyDB Omni umstellen möchten, die eine neuere Version von PostgreSQL unterstützt, müssen Sie sowohl den AlloyDB Omni-Betriebsmechanismus als auch Ihren Datenbankcluster aktualisieren. Jede Gruppe von AlloyDB Omni-Releases, die eine bestimmte PostgreSQL-Nebenversion unterstützt, hat eine eigene AlloyDB Omni-Betriebssystemversion. Sie finden sie in den Releasenotes für die AlloyDB Omni-Version.

Wenn Sie nur auf eine neuere Patchversion von AlloyDB Omni umstellen möchten, können Sie nur Ihren Datenbankcluster aktualisieren. Der AlloyDB Omni-Betriebsmechanismus selbst muss nicht aktualisiert werden.

Andernfalls fahren Sie mit dem Abschnitt AlloyDB Omni-Operator upgraden fort.

AlloyDB Omni-Operator aktualisieren

Kubernetes

So aktualisieren Sie den AlloyDB Omni-Operator:

  1. Definieren Sie die Umgebungsvariablen:

    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-Betriebssystems, auf die Sie umstellen, z. B. 1.1.0.

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

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

  3. Wenden Sie die neuesten Definitionen für benutzerdefinierte Ressourcen des AlloyDB Omni-Operators an:

    kubectl apply -f alloydbomni-operator/crds

  4. Führen Sie ein Upgrade des Helm-Diagramms für den AlloyDB Omni-Operator durch:

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

Nachdem Sie das Upgrade Ihres AlloyDB Omni-Betreibers abgeschlossen haben, folgen Sie der Anleitung unter Vor-Ort-Upgrade ausführen, um einen neuen Datenbankcluster zu erstellen.

Wenn Ihr AlloyDB Omni-Cluster mit AlloyDB Omni Operator 1.0.0 erstellt wurde, fügen Sie dem Manifest das Feld controlPlaneAgentsVersion hinzu und legen Sie es auf 1.1.0 fest, bevor Sie den Cluster auf Version 15.5.5 aktualisieren. Andernfalls wird der folgende Fehler angezeigt:

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

Ein Beispielmanifest mit dem Feld controlPlaneAgentsVersion sieht so aus:

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