Wartungsfenster für AlloyDB for PostgreSQL-Cluster verwalten

Durch das Konfigurieren von Wartungsfenstern und Sperrzeiten können Sie steuern, wann automatische Updates für Ihre AlloyDB for PostgreSQL-Cluster erfolgen, um Unterbrechungen während der Spitzenzeiten zu vermeiden. Sowohl für primäre als auch für sekundäre Cluster können Sie Wartungsfenster festlegen, ansehen oder löschen, anstehende geplante Wartungsereignisse überwachen und Sperrzeiten konfigurieren oder entfernen. Sie können auch E-Mail-Benachrichtigungen für geplante Wartungsereignisse aktivieren.

Eine Übersicht über die Funktionsweise der Wartung finden Sie unter Wartungsübersicht. Sie können auch nachlesen, wie Sie AlloyDB-Wartungsupdates mithilfe eines Staging-Clusters verwalten.

Hinweis

Damit bei Wartungsarbeiten und Updates temporäre Replikationsslots für die Zustandssynchronisierung erstellt werden können, muss die Gesamtzahl der Replikationsslots mindestens um eins unter dem Limit max_wal_senders liegen. Weitere Informationen zum Konfigurieren dieses Flags finden Sie unter Quellinstanzen konfigurieren.

Wartungsfenster für einen Cluster festlegen

Console

  1. Zur Clusterseite.

    Zu den Clustern

  2. Klicken Sie in der Spalte Ressourcenname auf einen Cluster.

  3. Klicken Sie auf der Seite Übersicht unter Wartung auf Bearbeiten.

  4. Wählen Sie unter Wartungsfenster den Wochentag für dieses Wartungsfenster aus.

    Die Standardoption ist Beliebiges Fenster. Wenn Sie einen Cluster erstellen, wird ihm dieses Standardwartungsfenster zugewiesen.

  5. Wählen Sie die Uhrzeit für dieses Wartungsfenster aus.

  6. Klicken Sie auf Aktualisieren, um die Änderungen zu speichern.

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 den Flags --maintenance-window-day und --maintenance-window-hour aus, um ein Wartungsfenster für einen Cluster festzulegen:

gcloud alloydb clusters update CLUSTER_ID \
  --region LOCATION_ID \
  --maintenance-window-day DAY_OF_WEEK \
  --maintenance-window-hour HOUR_OF_DAY

Ersetzen Sie Folgendes:

  • CLUSTER_ID: der Cluster, für den das Wartungsfenster festgelegt werden soll.

  • LOCATION_ID: Die Google Cloud Region, in der sich dieser Cluster befindet, z. B. us-central1.

  • DAY_OF_WEEK: der Wochentag in der Zeitzone UTC (Coordinated Universal Time) für dieses Wartungsfenster. Gültige Werte sind MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY und SUNDAY.

    Der Standardwert ist Beliebiges Fenster. Wenn Sie einen Cluster erstellen, wird ihm dieses Standardwartungsfenster zugewiesen.

  • HOUR_OF_DAY: eine Ganzzahl zwischen 0 und 23, die die Stunde des Tages in der UTC-Zeitzone für dieses Wartungsfenster darstellt.

Wenn Sie Änderungen an der Einstellung für das Wartungsfenster vornehmen, während der Cluster bereits gewartet wird oder eine Wartung geplant ist, werden die Änderungen erst nach Abschluss der aktuellen oder geplanten Wartung wirksam.

Wartungsfenster löschen

Console

  1. Zur Clusterseite.

    Zu den Clustern

  2. Klicken Sie in der Spalte Ressourcenname auf einen Cluster.

  3. Klicken Sie auf der Seite Übersicht unter Wartung auf Bearbeiten.

  4. Wählen Sie unter Wartungsfenster die Option Beliebiges Fenster aus.

  5. Klicken Sie auf Aktualisieren, um die Änderungen zu speichern.

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-window-any aus, um das Wartungsfenster aus einem Cluster zu entfernen:

gcloud alloydb clusters update CLUSTER_ID \
  --region LOCATION_ID \
  --maintenance-window-any

Ersetzen Sie Folgendes:

  • CLUSTER_ID: der Cluster, für den das Wartungsfenster festgelegt werden soll.

  • LOCATION_ID: die Google Cloud Region, in der sich dieser Cluster befindet, z. B. us-central1.

Wartungsfenster eines Clusters ansehen

Console

  1. Zur Clusterseite.

    Zu den Clustern

  2. Klicken Sie in der Spalte Ressourcenname auf einen Cluster.

  3. Sehen Sie sich auf der Seite Übersicht unter Wartung die Details zum Wartungsfenster für Ihren Cluster an.

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 describe aus, um das aktuelle Wartungsfenster für einen Cluster zu prüfen:

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

Ersetzen Sie Folgendes:

  • CLUSTER_ID: der Cluster, für den das Wartungsfenster festgelegt werden soll.

  • LOCATION_ID: die Google Cloud Region, in der sich dieser Cluster befindet, z. B. us-central1.

Wenn für den Cluster ein Wartungsfenster festgelegt ist, enthält die Ausgabe des Befehls Zeilen wie diese:

maintenanceUpdatePolicy:
  maintenanceWindows:
  - day: TUESDAY
    startTime:
      hours: 23

Wenn die Ausgabe keinen maintenanceUpdatePolicy-Abschnitt enthält, ist für den Cluster kein Wartungsfenster festgelegt.

Anstehende Wartung für einen Cluster ansehen

Console

  1. Zur Clusterseite.

    Zu den Clustern

  2. Suchen Sie Ihren Cluster und sehen Sie sich die Spalte Wartung an, um Informationen zum anstehenden Wartungsfenster zu erhalten.

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 describe aus, um die anstehende Wartung für einen Cluster aufzurufen, für den ein Wartungsfenster festgelegt ist:

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

Ersetzen Sie Folgendes:

  • CLUSTER_ID: der Cluster, für den das Wartungsfenster festgelegt werden soll.

  • LOCATION_ID: die Google Cloud Region, in der sich dieser Cluster befindet, z. B. us-central1.

Wenn für den Cluster ein geplantes Wartungsereignis ansteht, enthält die Ausgabe des Befehls Zeilen, die in etwa so aussehen:

maintenanceSchedule:
  startTime: 2024-07-03T09:46:40Z

Der UTC-formatierte Zeitstempel gibt den Zeitpunkt an, zu dem AlloyDB die Systemsoftware aller Knoten in diesem Cluster aktualisieren möchte.

Wartungsbenachrichtigungen aktivieren

Wartungsbenachrichtigungen sind standardmäßig deaktiviert. Wenn Sie sich für den Erhalt von E-Mail-Benachrichtigungen zu anstehenden AlloyDB-Wartungsereignissen entscheiden, beachten Sie Folgendes:

  • Sie erhalten eine automatische Benachrichtigung zum Termin, sobald er geplant ist. Wartungsereignisse werden mindestens eine Woche im Voraus geplant.
  • Wartungsbenachrichtigungen sind auf der Projektebene von Google Cloud aktiviert. Sie können sich nicht nur über eine Teilmenge von Clustern in einem Projekt benachrichtigen lassen.
  • Sie können Benachrichtigungen nur für sich selbst aktivieren. Jeder Nutzer muss separat aktiviert werden, um Wartungsbenachrichtigungen zu erhalten.

Weitere Informationen finden Sie unter Wartung – Übersicht.

So erhalten Sie eine automatische E-Mail-Benachrichtigung, wenn ein Wartungsereignis für einen Cluster mit einem Wartungsfenster geplant oder abgebrochen wird: Google Cloud

  1. Zur Clusterseite.

    Zu den Clustern

  2. Klicken Sie in der Spalte Ressourcenname auf einen Cluster.

  3. Klicken Sie auf der Seite Übersicht unter Wartung in der Zeile Notifications: auf Bearbeiten.

  4. Klicke auf Kommunikation.

  5. Wählen Sie in der Zeile für AlloyDB, Wartungsfenster die Ein/Aus-Schaltfläche in der Spalte E-Mail aus.

Zeitraum für den Wartungsausschluss konfigurieren

Wenn Sie Wartungsvorgänge während eines bestimmten Zeitraums verhindern möchten, können Sie einen Zeitraum für den Wartungsausschluss konfigurieren. Sie können die Wartungssperre für einen Cluster festlegen, auf dem die neueste Version von AlloyDB ausgeführt wird. Ein Zeitraum für den Wartungsausschluss kann 1 bis zu 30 Tage lang sein.

Cluster mit Instanzen in früheren Versionen unterstützen nicht immer das Festlegen von Sperrzeiträumen. Wenn Sie einen Sperrzeitraum für einen Cluster festlegen müssen, der nicht ausreichend auf dem neuesten Stand ist, können Sie eine Self-Service-Wartung durchführen, um den Cluster zu aktualisieren.

Vorhandene Ausschlusszeiträume blockieren die Self-Service-Wartung nicht.

Zeiträume für Wartungsausschluss festlegen

Um einen Zeitraum für den Wartungsausschluss zu konfigurieren, legen Sie hierfür das Startdatum, das Enddatum und die jeweilige Tageszeit fest.

Das Start- und Enddatum müssen im folgenden Format angegeben werden:

  • YYYY-MM-DD: gibt ein bestimmtes Datum an

Startdatum, Enddatum und Uhrzeit werden in der UTC-Zeitzone angegeben.

gcloud

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

Wenn Sie einem AlloyDB-Cluster einen Zeitraum für den Wartungsausschluss hinzufügen möchten, führen Sie den Befehl gcloud alloydb clusters update mit den Flags --deny-maintenance-period-start-date, --deny-maintenance-period-end-date und --deny-maintenance-period-time aus:

gcloud alloydb clusters update CLUSTER_ID \
   --region LOCATION_ID \
   --deny-maintenance-period-start-date START_DATE \
   --deny-maintenance-period-end-date END_DATE \
   --deny-maintenance-period-time TIME

Ersetzen Sie Folgendes:

  • CLUSTER_ID: der Cluster, der für den wartungsfreien Zeitraum konfiguriert werden soll.
  • LOCATION_ID: die Google Cloud Region, in der sich dieser Cluster befindet, z. B. us-central1.
  • START_DATE: das Startdatum des wartungsfreien Zeitraums im UTC-Format YYYY-MM-DD.
  • END_DATE: das Ende des wartungsfreien Zeitraums im UTC-Format YYYY-MM-DD.
  • TIME: die Uhrzeit des wartungsfreien Zeitraums im UTC-Format HH:MM. Die Stunden werden im 24-Stunden-Format dargestellt, wobei die Werte von 00:00 bis 23:59 reichen, z. B. 16:45.

REST Version 1

In diesem Beispiel wird einem vorhandenen Cluster ein Zeitraum für den Wartungsausschluss hinzugefügt. Eine vollständige Liste der Parameter für diesen Aufruf finden Sie unter Methode: projects.locations.clusters.patch.

Ersetzen Sie folgende Werte in den Anfragedaten:

  • CLUSTER_ID: der Cluster, der für den wartungsfreien Zeitraum konfiguriert 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.
  • START_YEAR: das Jahr, in dem der wartungsfreie Zeitraum beginnt, im Format YYYY.
  • START_MONTH: der Monat, in dem der wartungsfreie Zeitraum beginnt, im Format MM. Eine führende Null für einstellige Monate ist optional. Beispielsweise sind sowohl 2 als auch 02 für Februar gültig.
  • START_DAY: der Tag, an dem der wartungsfreie Zeitraum im Format DD beginnt. Eine führende Null für einstellige Tage ist optional. Beispielsweise sind sowohl 1 als auch 01 für den ersten Tag des Monats gültig.
  • END_YEAR: das Jahr, in dem der wartungsfreie Zeitraum endet, im Format YYYY.
  • END_MONTH: der Monat, in dem der wartungsfreie Zeitraum endet, im Format MM.
  • END_DAY: der Tag, an dem der wartungsfreie Zeitraum endet, im Format DD.
  • HOURS: die Stunde des wartungsfreien Zeitraums im 24-Stunden-Format, z. B. 16. Eine führende Null für einstellige Stunden ist optional. Beispielsweise sind sowohl 2 als auch 02 gültig.
  • MINUTES: die Minute des wartungsfreien Zeitraums, die Werte von 0 bis 59 akzeptiert, z. B. 45. Eine führende Null für einstellige Minuten ist optional. 7 und 07 sind gültig.

Verwenden Sie die folgende PATCH-Anfrage, um einen Zeitraum für den Wartungsausschluss hinzuzufügen:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_update_policy.deny_maintenance_periods

Der Suchparameter maintenance_update_policy.deny_maintenance_periods weist die API an, das Feld denyMaintenancePeriods im Block maintenanceUpdatePolicy zu aktualisieren.

Der JSON-Anfragetext sieht so aus:

{
 "maintenanceUpdatePolicy": {
   "denyMaintenancePeriods": [
     {
       "startDate": {
         "year": START_YEAR,
         "month": START_MONTH,
         "day": START_DAY
       },
       "endDate": {
         "year": END_YEAR,
         "month": END_MONTH,
         "day": END_DAY
       },
       "time": {
         "hours": HOURS,
         "minutes": MINUTES
       }
     }
   ]
 }
}

Anstehende Wartung ablehnen

Zeiträume für den Wartungsausschluss haben Vorrang vor geplanter Wartung. Wenn ein Zeitkonflikt auftritt, überschreibt der Zeitraum für den Wartungsausschluss das geplante Wartungsfenster.

Wenn Sie einen Ausschlusszeitraum festlegen, der mit einem geplanten Wartungsereignis in Konflikt steht, wird die Wartung nicht sofort abgebrochen und der Zeitplan nicht gelöscht. AlloyDB zeigt die geplante Wartung als anstehend an, bricht das geplante Wartungsfenster jedoch ab, wenn die geplante Zeit beginnt.

Damit kritische Updates angewendet werden können, lässt das System in der Regel nicht zu, dass ein Sperrzeitraum festgelegt wird, um mehr als ein Wartungsereignis zu überspringen. In seltenen Fällen kann es vorkommen, dass Notfallwartungen außerhalb der konfigurierten Wartungseinstellungen durchgeführt werden.

Zeitraum für den Wartungsausschluss aus einem Cluster entfernen

Sie können einen Zeitraum für den Wartungsausschluss jederzeit entfernen.

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 --remove-deny-maintenance-period aus, um einen Zeitraum für den Wartungsausschluss aus einem AlloyDB-Cluster zu entfernen:

gcloud alloydb clusters update CLUSTER_ID --region LOCATION_ID  --remove-deny-maintenance-period

Ersetzen Sie Folgendes:

  • CLUSTER_ID: der Cluster, aus dem der Zeitraum für den Wartungsausschluss entfernt werden soll.
  • LOCATION_ID: die Google Cloud Region, in der sich dieser Cluster befindet, z. B. us-central1.

REST Version 1

In diesem Beispiel wird ein Zeitraum für den Wartungsausschluss aus einem AlloyDB-Cluster entfernt. Eine vollständige Liste der Parameter für diesen Aufruf finden Sie unter Methode: projects.locations.clusters.patch.

Ersetzen Sie folgende Werte in den Anfragedaten:

  • CLUSTER_ID: Die ID des Clusters, dem Sie einen Zeitraum für den Wartungsausschluss hinzufügen.
  • 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 einen Zeitraum für den Wartungsausschluss zu entfernen:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_update_policy.deny_maintenance_periods

Der Suchparameter maintenance_update_policy.deny_maintenance_periods weist die API an, das Feld denyMaintenancePeriods im Block maintenanceUpdatePolicy zu aktualisieren.

Der JSON-Anfragetext sieht so aus:

{}

Nächste Schritte