Zur neuesten Version des AlloyDB Omni Kubernetes-Operators migrieren

Wählen Sie eine Dokumentationsversion aus:

Auf dieser Seite finden Sie eine Anleitung für das Upgrade von Version 1.0.0 auf Version 1.1.0 des AlloyDB Omni-Operators.

Die Schritte, die Sie zum Upgraden von AlloyDB Omni in Kubernetes ausführen, hängen von der Version von AlloyDB Omni ab, die Sie ausführen, und von der Version, auf die Sie upgraden.

Aktuelle Versionsnummern ermitteln

Kubernetes

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 Folgendes:

  • 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, wird mit diesem Befehl die Versionsnummer des AlloyDB Omni-Operators ausgegeben, der in Ihrem Kubernetes-Cluster ausgeführt wird.

Wenn Sie eine Version des AlloyDB Omni Operator vor 1.0.0 ausführen, folgen Sie der Anleitung unter Upgrade von einem AlloyDB Omni Operator vor Version 1.0.0 durchführen.

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

Zielversionsnummern prüfen

Kubernetes

Wenn Sie eine Version von AlloyDB Omni Operator 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 müssen Sie die Versionsnummer von AlloyDB Omni kennen.

Die AlloyDB Omni-Versionsnummer hat die folgenden Komponenten:

  • Die Hauptversionsnummer der PostgreSQL-Kompatibilität
  • Die Nebenversionsnummer der PostgreSQL-Kompatibilität
  • Die Patchversionsnummer dieses AlloyDB Omni-Release

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 aktualisieren möchten, die eine neuere Version von PostgreSQL unterstützt, müssen Sie den AlloyDB Omni-Operator zusammen mit Ihrem Datenbankcluster aktualisieren. Jede Gruppe von AlloyDB Omni-Releases, die eine bestimmte PostgreSQL-Nebenversion unterstützen, hat eine eigene AlloyDB Omni Operator-Versionsnummer. Diese finden Sie in den Versionshinweisen für die AlloyDB Omni-Version.

Wenn Sie nur auf eine neuere Patchversion von AlloyDB Omni aktualisieren möchten, können Sie nur Ihren Datenbankcluster aktualisieren. Ein Upgrade des AlloyDB Omni-Operators selbst ist nicht erforderlich.

Fahren Sie andernfalls mit dem Abschnitt AlloyDB Omni-Operator aktualisieren 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-Operators, auf die Sie aktualisieren, z. B. 1.1.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

Nachdem Sie das Upgrade Ihres AlloyDB Omni-Operators abgeschlossen haben, folgen Sie der Anleitung unter In-Place-Upgrade durchfü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 das 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"
...