Zur neuesten Version des AlloyDB Omni Kubernetes-Operators migrieren

Wählen Sie eine Dokumentationsversion aus:

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 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. Fahren Sie andernfalls mit Zielversionsnummern prüfen fort.

Zielversionsnummern prüfen

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 ausführen möchten. 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

AlloyDB Omni-Version 15.7.0 unterstützt beispielsweise 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 aktualisieren
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 PostgreSQL-Nebenversion unterstützt, hat eine eigene AlloyDB Omni-Operatorversionsnummer. Diese finden Sie in den Versionshinweisen für die AlloyDB Omni-Version. Prüfen Sie in der Kompatibilitätstabelle für AlloyDB Omni-Operatorversionen, ob Ihre AlloyDB Omni-Operatorversion mit Ihrer Operatorversion kompatibel ist.
Sie möchten nur ein Upgrade auf eine neuere Patchversion von AlloyDB Omni durchführen. Führen Sie ein Upgrade nur für Ihren Datenbankcluster durch. Sehen Sie in der Kompatibilitätstabelle für AlloyDB Omni-Operator-Versionen und den Versionshinweisen nach, bevor Sie ein Upgrade durchführen, um festzustellen, ob Sie auch den AlloyDB Omni-Operator aktualisieren müssen.
Alle anderen Szenarien Folgen Sie der Anleitung zum Aktualisieren des AlloyDB Omni-Operators.

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 durchführen, 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 die dbCluster aktualisieren möchten, müssen Sie die Versionen von databaseVersion und controlPlaneAgentsVersion in der Manifestdatei aktualisieren. Im Folgenden sehen Sie einen 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"
    ...