Zur neuesten Version des AlloyDB Omni Kubernetes-Operators migrieren

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

Aktuelle Versionen ermitteln

Führen Sie 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. Dies ist der Name des Datenbankclusters, den Sie beim Erstellen angegeben haben.

  • NAMESPACE: der Kubernetes-Namespace Ihres Datenbankclusters.

Wenn Sie Version 1.0.0 oder höher des AlloyDB Omni-Betriebssystems 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 ausführen. Fahren Sie andernfalls mit Zielordnernummern prüfen fort.

Zielversionsnummern prüfen

Wenn Sie eine Version des AlloyDB Omni-Betriebssystems 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 ausführen möchten. 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.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 zum Aktualisieren
Sie möchten auf eine Version von AlloyDB Omni umstellen, die eine neuere Version von PostgreSQL unterstützt. Führen Sie ein Upgrade des AlloyDB Omni-Betriebs und Ihres Datenbankclusters durch. Jede Gruppe von AlloyDB Omni-Releases, die eine bestimmte PostgreSQL-Nebenversion unterstützt, hat eine eigene AlloyDB Omni-Betriebssystemversion. Sie finden sie in den Versionshinweisen für die AlloyDB Omni-Version. In der Kompatibilitätstabelle für AlloyDB Omni-Betreiberversionen können Sie prüfen, ob Ihre AlloyDB Omni-Betreiberversion mit Ihrer Betreiberversion kompatibel ist.
Sie möchten nur ein Upgrade auf eine neuere Patchversion von AlloyDB Omni durchführen. Upgraden Sie nur Ihren Datenbankcluster. Sehen Sie sich vor dem Upgrade die Kompatibilitätstabelle für AlloyDB Omni-Operatorversionen und die Versionshinweise an, 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 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 ein Upgrade ausführen, z. B. 1.2.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 benutzerdefinierten Ressourcendefinitionen des AlloyDB Omni-Betriebssystems 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

    Wenn Sie dbCluster aktualisieren möchten, müssen Sie die databaseVersion- und controlPlaneAgentsVersion-Versionen in der Manifestdatei aktualisieren. Im Folgenden ist ein Teil einer Manifestdatei zu sehen, in der Version 15.7.0 von databaseVersion und Version 1.2.0 von controlPlaneAgentsVersion angegeben sind:

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