Wartungsfenster für Ihre Umgebungen angeben

Auf dieser Seite wird erläutert, wie Sie Wartungsfenster für Ihre Umgebungen definieren.

Cloud Composer-Umgebungen basieren auf anderen Google Cloud-Diensten. Einige dieser Dienste erfordern Wartungsvorgänge, z. B. beim Patchen der Konfiguration einer vorhandenen Ressource. Für GKE- und Cloud SQL-Ressourcen sind oft Wartungsvorgänge erforderlich.

Wartungsfenster verwenden

Wartungsvorgänge können die Ausführung Ihrer DAG- und Airflow-Aufgaben beeinflussen. Daher sollten Sie folgende Schritte ausführen:

  1. Definieren Sie Wartungsfenster für Ihre Cloud Composer-Umgebungen.

  2. Mit den Parametern start_date und schedule_interval können Sie DAGs außerhalb festgelegter Wartungsfenster ausführen.

Sie können Wartungsfenster für neue und vorhandene Cloud Composer-Umgebungen definieren. Wenn Sie keine expliziten Wartungsfenster angeben, wird der Zeitraum für Wartungsvorgänge automatisch ausgewählt, ohne dass der Zeitplan für die Ausführung von DAGs berücksichtigt wird.

Wartungsfenster für neue Umgebungen festlegen

Console

So definieren Sie Wartungsfenster beim Erstellen einer Umgebung:

  1. Rufen Sie in der Google Cloud Console die Seite Umgebung erstellen auf.

    Zur Seite "Umgebung erstellen"

  2. Maximieren Sie den Bereich Netzwerk, Airflow-Konfigurationsüberschreibungen und zusätzliche Funktionen.

  3. Klicken Sie im Abschnitt Wartungsfenster das Kästchen Benutzerdefinierte Zeit für Wartungsfenster festlegen an.

  4. Legen Sie Startzeit, Zeitzone, Tage und Dauer fest, damit die gesamte Zeit für den angegebenen Zeitplan kombiniert wird. mindestens sieben Stunden in einem siebentägigen rollierenden Zeitfenster. Zum Beispiel gibt ein Zeitraum von 4 Stunden an jedem Montag, Mittwoch und Freitag die erforderliche Zeit an.

  5. Führen Sie alle anderen Schritte aus, um eine Umgebung zu erstellen.

gcloud

Beim Erstellen einer Umgebung definieren die folgenden Argumente Parameter für Wartungsfenster:

  • --maintenance-window-start legt die Startzeit eines Wartungsfensters fest.
  • --maintenance-window-end legt das Ende eines Wartungsfensters fest.
  • --maintenance-window-recurrence legt die Wiederholung des Wartungsfensters fest.
gcloud beta composer environments create ENVIRONMENT_NAME \
    --location LOCATION \
    --maintenance-window-start 'DATETIME_START' \
    --maintenance-window-end 'DATETIME_END' \
    --maintenance-window-recurrence 'MAINTENANCE_RECURRENCE'

Ersetzen Sie:

  • ENVIRONMENT_NAME durch den Namen der Umgebung.
  • DATETIME_START mit dem Startdatum und der Startzeit im Eingabeformat für Datum und Uhrzeit. Wird nur die angegebene Tageszeit verwendet, wird das angegebene Datum ignoriert.
  • DATETIME_END mit dem Enddatum und der Endzeit im Eingabeformat für Datum und Uhrzeit. Wird nur die angegebene Tageszeit verwendet, wird das angegebene Datum ignoriert. Das angegebene Datum und die angegebene Uhrzeit müssen nach dem Startdatum liegen.
  • MAINTENANCE_RECURRENCE mit RFC 5545 RRULE für die Wiederherstellung von Wartungsfenstern. Cloud Composer unterstützt zwei Formate:

    • Das Format FREQ=DAILY gibt eine tägliche Wiederholung an.
    • Das Format FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA gibt eine Wiederholung an ausgewählten Wochentagen an.

Im folgenden Beispiel wird ein sechsstündiges Wartungsfenster zwischen 01:00 und 07:00 (UTC) am Sonntag, Mittwoch und Samstag angegeben. Das Datum vom 1. Januar 2021 wird ignoriert.

gcloud beta composer environments create example-environment \
  --location us-central1 \
  --maintenance-window-start '2021-01-01T01:00:00Z' \
  --maintenance-window-end '2021-01-01T07:00:00Z' \
  --maintenance-window-recurrence 'FREQ=WEEKLY;BYDAY=SU,WE,SA'

Wartungsfenster für vorhandene Umgebungen festlegen

Console

Damit Sie Wartungsfenster für eine vorhandene Umgebung definieren oder ändern können, aktualisieren Sie die Umgebung:

  1. Rufen Sie in der Google Cloud Console die Seite Umgebungen auf.

Zur Seite "Umgebungen"

  1. Wählen Sie eine Umgebung aus, um die zugehörigen Details aufzurufen.

  2. Wechseln Sie zum Tab Umgebungskonfiguration.

  3. Klicken Sie neben dem Eintrag Wartungsfenster auf Bearbeiten.

  4. Klicken Sie im Dialogfeld Wartungsfenster auf das Kästchen Benutzerdefinierte Zeit für Wartungsfenster festlegen.

  5. Legen Sie Startzeit, Zeitzone, Tage und Dauer fest, damit die gesamte Zeit für den angegebenen Zeitplan kombiniert wird. mindestens sieben Stunden in einem siebentägigen rollierenden Zeitfenster. Zum Beispiel gibt ein Zeitraum von 4 Stunden an jedem Montag, Mittwoch und Freitag die erforderliche Zeit an.

  6. Klicken Sie auf Speichern und warten Sie, bis die Umgebung aktualisiert wird.

gcloud

Wenn Sie eine Umgebung aktualisieren, definieren die folgenden Argumente Parameter für Wartungsfenster:

  • --maintenance-window-start legt die Startzeit eines Wartungsfensters fest.
  • --maintenance-window-end legt das Ende eines Wartungsfensters fest.
  • --maintenance-window-recurrence legt die Wiederholung des Wartungsfensters fest.
gcloud beta composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --maintenance-window-start 'DATETIME_START' \
    --maintenance-window-end 'DATETIME_END' \
    --maintenance-window-recurrence 'MAINTENANCE_RECURRENCE'

Ersetzen Sie:

  • ENVIRONMENT_NAME durch den Namen der Umgebung.
  • DATETIME_START mit dem Startdatum und der Startzeit im Eingabeformat für Datum und Uhrzeit. Wird nur die angegebene Tageszeit verwendet, wird das angegebene Datum ignoriert.
  • DATETIME_END mit dem Enddatum und der Endzeit im Eingabeformat für Datum und Uhrzeit. Wird nur die angegebene Tageszeit verwendet, wird das angegebene Datum ignoriert. Das angegebene Datum und die angegebene Uhrzeit müssen nach dem Startdatum liegen.
  • MAINTENANCE_RECURRENCE mit RFC 5545 RRULE für die Wiederherstellung von Wartungsfenstern. Cloud Composer unterstützt zwei Formate:

    • Das Format FREQ=DAILY gibt eine tägliche Wiederholung an.
    • Das Format FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA gibt eine Wiederholung an ausgewählten Wochentagen an.

Im folgenden Beispiel wird ein sechsstündiges Wartungsfenster zwischen 01:00 und 07:00 (UTC) am Sonntag, Mittwoch und Samstag angegeben. Das Datum vom 1. Januar 2021 wird ignoriert.

gcloud beta composer environments update example-environment \
  --location us-central1 \
  --maintenance-window-start '2021-01-01T01:00:00Z' \
  --maintenance-window-end '2021-01-01T07:00:00Z' \
  --maintenance-window-recurrence 'FREQ=WEEKLY;BYDAY=SU,WE,SA'

Nächste Schritte