Self-Service-Wartung durchführen

Sie können die Self-Service-Wartung durchführen, wenn Sie die neuesten AlloyDB for PostgreSQL-Updates so schnell wie möglich auf Ihre Cluster anwenden müssen. Wenn Sie auf die neueste Version aktualisieren, können Sie AlloyDB-Funktionen nutzen, Patches anwenden und einen Sperrzeitraum festlegen, um Unterbrechungen in sensiblen Zeiträumen zu vermeiden.

Weitere Informationen finden Sie unter Wartung – Übersicht.

Anwendungsfälle für die Selbstwartung

AlloyDB führt in der Regel Wartungsarbeiten an Ihren Clustern durch und aktualisiert die Datenbanksoftware in Clustern. Standardmäßig führt AlloyDB Wartungsarbeiten außerhalb der regionalen Geschäftszeiten durch. Optional können Sie ein Wartungsfenster festlegen, um eine bevorzugte Zeit für die geplante Wartung zu definieren und Benachrichtigungen über bevorstehende geplante Wartungen zu erhalten. Bei einem bestimmten Release und einer bestimmten PostgreSQL-Version wird die Wartung zuerst für Cluster ohne Wartungsfenster abgeschlossen und dann für Cluster mit Wartungsfenstern geplant.

Es gibt verschiedene Gründe, warum Sie sich für die Selbstwartung entscheiden könnten:

  • Die Wartung Ihres Clusters wurde übersprungen. Dies tritt auf, wenn Sie einen Ablehnungszeitraum einrichten oder sich Ihr Cluster während der Migration in einem Bootstrap-Zustand befand.
  • Ihr Cluster muss vor der geplanten Wartung aktualisiert werden.
  • Sie müssen einen Ablehnungszeitraum für einen Cluster festlegen, der nicht auf dem neuesten Stand ist. Bei Clustern mit Instanzen in früheren Versionen wird das Festlegen von Ablehnungszeiträumen nicht immer unterstützt.
  • Sie möchten die Wartung in einem benutzerdefinierten oder unregelmäßigen Rhythmus ausführen. In diesem Fall können Sie einen Zeitraum für den Wartungsausschluss festlegen und dann bei Bedarf eine Self-Service-Wartung durchführen. Ausschlusszeiträume blockieren keine Self-Service-Wartung.

Ressourcendetaillierungsgrad bei Updates

AlloyDB unterstützt die Wartung nur auf Clusterebene. Innerhalb des Clusters bestimmt AlloyDB die Reihenfolge der Instanzupdates. AlloyDB versucht, die Wartung für jede Instanz unabhängig durchzuführen und abzuschließen. Daher ist es möglich, dass Instanzen unterschiedliche Releases verwenden. Bei einem Cluster kann es beispielsweise vorkommen, dass die Wartung vorhandener Instanzen aufgrund eines Sperrzeitraums übersprungen wird und dann eine Instanz in der neuesten Version erstellt wird.

Neueste verfügbare Version ansehen

Die aktuelle Version finden Sie in den Änderungslogs für die Wartung von AlloyDB. Das Changelog wird aktualisiert, nachdem die Wartung auf Cluster in allen Regionen angewendet wurde. Weitere Informationen dazu, wie die neuesten Versionen auf Regionen angewendet werden, finden Sie unter Neueste Version.

Aktuelle Version einer Instanz ansehen

Wenn Sie die gcloud CLI verwenden möchten, können Sie die Google Cloud CLI installieren und initialisieren oder Cloud Shell verwenden.

Die Version kann nur auf Instanzebene aufgerufen werden.

  1. Führen Sie den Befehl gcloud alloydb instances describe aus, um die aktuelle Wartungsversion der Instanz aufzurufen:

    gcloud alloydb instances describe INSTANCE_ID \
--cluster CLUSTER_ID \
--region LOCATION_ID

    Ersetzen Sie Folgendes:

    • INSTANCE_ID: Die ID der Instanz, für die Sie die Version ansehen.
    • CLUSTER_ID: Die ID des Clusters, in dem sich die Instanz befindet.
    • LOCATION_ID: Die Google Cloud Region, in der sich dieser Cluster befindet, z. B. us-central1.

  2. Suchen Sie in der Antwort nach dem Feld maintenanceVersionName, um die Version zu sehen, in der die Instanz ausgeführt wird. Beispiel:

    "maintenanceVersionName": "POSTGRES_16.20251015.04_00"

Cluster auf die neueste verfügbare Version aktualisieren

gcloud

Wenn Sie die gcloud CLI verwenden möchten, können Sie die Google Cloud CLI installieren und initialisieren oder Cloud Shell verwenden.

Führen Sie den Befehl gcloud alloydb clusters update mit dem Flag maintenance-version aus, um den Cluster auf die neueste Version zu aktualisieren:

gcloud alloydb clusters update CLUSTER_ID \
--region LOCATION_ID \
--maintenance-version=latest

Ersetzen Sie Folgendes:

  • CLUSTER_ID: Die ID des Clusters, der auf die neueste Version aktualisiert werden soll.
  • LOCATION_ID: die Google Cloud Region, in der sich dieser Cluster befindet, z. B. us-central1.

Beispielantwort:

Operation ID: operation-1746645915198-63490b152e3c8-2aed1bd1-3fd73867
Updating cluster...done.

REST Version 1

In diesem Beispiel wird dieser Cluster auf die aktuelle Version aktualisiert. Eine vollständige Liste der Parameter für diesen Aufruf finden Sie unter Methode: projects.locations.clusters.patch.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • CLUSTER_ID: der Cluster, der auf die neueste Version aktualisiert werden soll.
  • PROJECT_ID: die ID des Projekts, in dem sich der Cluster befindet.
  • LOCATION_ID: die Google Cloud Region, in der sich dieser Cluster befindet, z. B. us-central1.

Verwenden Sie die folgende PATCH-Anfrage, um Ihren Cluster auf die neueste Version zu aktualisieren:

PATCH https://alloydb.googleapis.com/v1/{cluster.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_version_selection_policy}

Der Abfrageparameter maintenance_version_selection_policy gibt die Version an, auf die die Instanzen des Clusters aktualisiert werden sollen.

Der JSON-Anfragetext sieht so aus:

{
  "maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}

Nächste Schritte