Zur neuesten Version des AlloyDB Omni Kubernetes-Operators migrieren
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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.

Hinweise

Wenn Sie den AlloyDB Omni-Operator aktualisieren, wird die Datenbank neu gestartet, es sei denn, alle der folgenden Bedingungen sind erfüllt:

Sie führen ein Upgrade von der AlloyDB Omni-Operatorversion 1.1.1 auf eine neuere Version durch.
Sie verwenden die AlloyDB Omni-Datenbankversion 15.5.5 oder höher.
AlloyDB AI ist nicht aktiviert.

Wenn die Datenbank neu gestartet wird, gehen keine Daten verloren.

Ab der AlloyDB Omni-Datenbankversion 15.7.1 wird für die Hochverfügbarkeit (High Availability, HA) in Ihren Kubernetes-basierten AlloyDB Omni-Datenbankclustern eine neue Architektur verwendet, die eine bessere Härtung und Verbesserungen bei der automatischen Einrichtung, dem Failover und der Wiederherstellung von HA bietet.

Wenn Sie die AlloyDB Omni-Datenbankversion von 15.7.0 (oder niedriger) auf Version 15.7.1 (oder höher) aktualisieren oder ein Downgrade ausführen, müssen Sie HA vor dem Upgrade deaktivieren und nach Abschluss des Upgrades wieder aktivieren.

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. 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.1 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:

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.4.0.

Laden Sie den neuesten AlloyDB Omni-Operator herunter:

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

Wenden Sie die neuesten benutzerdefinierten Ressourcendefinitionen des AlloyDB Omni-Betriebssystems an:
```
kubectl apply -f alloydbomni-operator/crds
```

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

Datenbankcluster aktualisieren

So aktualisieren Sie die dbCluster:

Wenn Sie ein Upgrade eines HA-AlloyDB Omni-Datenbankclusters von der Datenbankversion 15.7.0 (oder niedriger) auf Version 15.7.1 (oder höher) durchführen, setzen Sie numberOfStandbys im Manifest des Clusters auf 0 und wenden Sie das Manifest noch einmal an, um HA zu deaktivieren:
```
spec:
  availability:
    numberOfStandbys: 0
```
Sie müssen HA nicht deaktivieren, wenn Sie von einer älteren Version auf Version 15.7.0 (oder niedriger) oder von Version 15.7.1 (oder höher) auf eine neuere Version aktualisieren.
Aktualisieren Sie die databaseVersion- und die controlPlaneAgentsVersion-Versionen im Manifest des Clusters und wenden Sie das Manifest noch einmal an.

Im Folgenden ist ein Teil einer Manifestdatei zu sehen, in der die Version 15.7.1 von databaseVersion und die Version 1.4.0 von controlPlaneAgentsVersion angegeben sind:
```
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
spec:
  databaseVersion: "15.7.1"
  controlPlaneAgentsVersion: "1.4.0"
...
```
Warten Sie, bis das Upgrade abgeschlossen ist.
Wenn Sie HA vor dem Upgrade deaktiviert haben, können Sie die numberOfStandbys im Manifest des Clusters auf die Zahl vor dem Upgrade zurücksetzen und das Manifest wieder anwenden, um HA wieder zu aktivieren.

`alloydb_omni_instance_postgresql_wait_time_second_total` aktualisieren

Wenn Sie den Messwert alloydb_omni_instance_postgresql_wait_time_second_total verwenden, müssen Sie ihn auf alloydb_omni_instance_postgresql_wait_time_us_total aktualisieren. Wenn Sie beide Messwerte verwenden möchten, verwenden Sie den Prometheus-Operator OR.

(promQL A) OR (promQL A, but replace all occurrences of alloydb_omni_instance_postgresql_wait_time_second_total to alloydb_omni_instance_postgresql_wait_time_us_total)

Wenn Sie seconds als Maßeinheit für diesen Messwert verwenden, müssen Sie ihn in us umrechnen.

Weitere Informationen finden Sie in den Versionshinweisen.

Zur neuesten Version des AlloyDB Omni Kubernetes-Operators migrieren Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.