Diese Seite wurde von der Cloud Translation API übersetzt.

AlloyDB Omni Kubernetes-Operator auf Version 1.4.0 aktualisieren

Wählen Sie eine Dokumentationsversion aus:

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

Hinweise

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

Sie führen ein Upgrade des AlloyDB Omni-Operators von Version 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. Weitere Informationen finden Sie unter Datenbankcluster mit AlloyDB AI erstellen.

Wenn die Datenbank neu gestartet wird, ist kein Datenverlust zu erwarten.

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 mehr Härtung und Verbesserungen für die automatische Einrichtung, das Failover und die Reparaturfunktionen von HA bietet.

Wenn Sie die AlloyDB Omni-Datenbankversion von 15.7.0 (oder früher) auf Version 15.7.1 (oder höher) aktualisieren oder ein Downgrade der Versionen durchführen, müssen Sie die HA deaktivieren und nach Abschluss des Vorgangs 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. Das ist derselbe Datenbankclustername, den Sie beim Erstellen angegeben haben. Weitere Informationen finden Sie unter AlloyDB Omni in Kubernetes installieren.
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. Andernfalls prüfen Sie die Versionsnummern des Ziels.

Zielversionsnummern prüfen

Wenn Sie eine Version des AlloyDB Omni-Operators ab 1.0.0 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 16.3.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-Operator-Versionsnummer. 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.
Alle anderen Szenarien	Folgen Sie der Anleitung zum Aktualisieren des AlloyDB Omni-Operators.

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:

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

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

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

Datenbankcluster aktualisieren

So aktualisieren Sie die dbCluster:

Wenn Sie ein Upgrade eines AlloyDB Omni-Datenbankclusters mit Hochverfügbarkeit von Datenbankversion 15.7.0 (oder früher) auf Version 15.7.1 (oder höher) durchführen, folgen Sie dieser Anleitung, um die Hochverfügbarkeit zu deaktivieren.

Hinweis: Wenn Sie ein Upgrade von einer älteren Version auf Version 15.7.0 (oder früher) oder von Version 15.7.1 (oder höher) auf eine neuere Version durchführen, überspringen Sie diesen Schritt.
1. Setzen Sie numberOfStandbys im Manifest des Clusters auf 0.
```
spec:
  availability:
    numberOfStandbys: 0
```
1. Wenn Sie HA deaktivieren möchten, wenden Sie das Manifest noch einmal an.
Aktualisieren Sie die databaseVersion- und controlPlaneAgentsVersion-Versionen im Manifest des Clusters und wenden Sie das Manifest noch einmal an.

Führen Sie das folgende Beispiel aus, das Teil einer Manifestdatei ist, in der Version 16.3.0 von databaseVersion und Version 1.4.0 von controlPlaneAgentsVersion angegeben sind:
```
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
spec:
  databaseVersion: "16.3.0"
  controlPlaneAgentsVersion: "1.4.0"
...
```
Ersetzen Sie die folgende Variable:
- DB_CLUSTER_NAME: Der Name Ihres Datenbankclusters. Das ist derselbe Datenbankclustername, den Sie beim Erstellen angegeben haben. Weitere Informationen finden Sie unter AlloyDB Omni auf Kubernetes installieren.
Warten Sie, bis das Upgrade erfolgreich abgeschlossen ist.
Wenn Sie HA vor dem Upgrade deaktiviert haben, führen Sie die folgenden Schritte aus.
1. Legen Sie im Manifest des Clusters numberOfStandbys wieder auf die Zahl vor dem Upgrade fest.
2. Wenden Sie das Manifest noch einmal an, 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 Einheit für diesen Messwert verwenden, müssen Sie ihn in us umrechnen.

Weitere Informationen finden Sie in den Versionshinweisen.