Wartungsfenster konfigurieren

Auf dieser Seite wird erläutert, wie Sie Wartungsfenster für Cloud Data Fusion-Instanzen definieren.

Wartungsfenster werden für Cloud Data Fusion-Instanzen in Version 6.8.0 und höher unterstützt.

Wartungsfenster

Ein Wartungsfenster in Cloud Data Fusion ist ein Zeitraum, in dem Wartungsvorgänge durchgeführt werden dürfen. So wird das Risiko von Dienstunterbrechungen während Spitzennutzungszeiten verringert. Wenn Sie Wartungsfenster außerhalb der Spitzenzeiten oder zu Zeiten mit geringerer Aktivität planen, werden die Auswirkungen auf Ihre Cloud Data Fusion-Instanzen und Ihre Pipelineausführungen minimiert.

Durch das Konfigurieren von Wartungsfenstern können Sie steuern, wann Wartungsvorgänge in der Instanz erfolgen:

  • Wenn das Wartungsfenster definiert ist, werden Wartungsvorgänge von Cloud Data Fusion innerhalb der festgelegten Zeiträume ausgeführt.
  • Wenn das Wartungsfenster nicht definiert ist, kann die Wartung jederzeit durchgeführt werden.

Wartungsvorgänge

Um die Systemsicherheit und Compliance zu gewährleisten, führt Cloud Data Fusion regelmäßige Wartungsarbeiten durch. Dazu gehören auch die Anwendung wichtiger Updates und Sicherheits-Patches, um Sicherheitslücken zu schließen und Nutzerdaten zu schützen. Geplante Wartungsfenster sorgen dafür, dass die Updates effizient angewendet werden, die Systemintegrität erhalten bleibt und Unterbrechungen von Instanzen und Pipelineausführungen minimiert werden.

  • Wenn Sie die Wartungsfenster konfigurieren, müssen Sie mindestens 12 Stunden pro Woche für Wartungsvorgänge einplanen. Jedes Fenster muss zwischen 4 und 12 Stunden lang sein.

  • Während des Wartungszeitraums können bestimmte Vorgänge beeinträchtigt sein. Wir empfehlen, Wartungsfenster außerhalb der Hauptnutzungszeiten festzulegen. Die Wartung kann sich auf Cloud Data Fusion folgendermaßen auswirken:

    • Die Cloud Data Fusion Studio-Benutzeroberfläche ist möglicherweise vorübergehend nicht verfügbar.
    • Die Pipelineausführung kann beeinträchtigt werden, was zu einem Fehler führt.
    • Cloud Data Fusion-Dienste sind möglicherweise vorübergehend nicht verfügbar, was zu fehlgeschlagenen API-Aufrufen führt.
    • Innerhalb des Wartungsfensters sind Instanzen möglicherweise bis zu eine Stunde lang nicht voll funktionsfähig. Wir empfehlen, Wartungsfenster einzurichten, wenn Ihre Pipelines entweder nicht ausgeführt werden oder keine Ausführung geplant ist.

Wartungsfenster beim Erstellen einer Instanz angeben

Console

So legen Sie das Wartungsfenster beim Erstellen einer Instanz fest:

  1. Rufen Sie die Seite Cloud Data Fusion-Instanzen auf und klicken Sie auf Instanz erstellen.

    Instanz erstellen

  2. Geben Sie einen Instanznamen und eine Version ein. Weitere Informationen zu den einzelnen Feldern finden Sie unter Instanz erstellen.
  3. Maximieren Sie den Bereich Erweiterte Optionen.
  4. Maximieren Sie den Bereich Wartung und führen Sie die folgenden Schritte aus:
    1. Klicken Sie auf das Kästchen Wartungsfenster aktivieren.
    2. Geben Sie im Feld Beginn eine Uhrzeit in einem unterstützten Format ein.
    3. Wählen Sie in der Liste Zeitzone eine Zeitzone aus.
    4. Wählen Sie in den Listen Tage und Dauer die Wochentage und die Dauer des Wartungsfensters aus. Weitere Informationen zu diesen Einstellungen finden Sie unter Wartungsvorgänge.
    5. Klicken Sie auf Erstellen.

Weitere Informationen finden Sie unter Wartungsfenster konfigurieren.

REST API

  1. Legen Sie die Instance-Konfiguration mit der instance.create API fest:
{
  "name": string,
  "description": string,
  …
  …
  "maintenancePolicy": {
    "maintenanceWindow": {
      "recurringTimeWindow": {
        "window": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
        },
        "recurrence": "MAINTENANCE_RECURRENCE"
      }
    },
  }
}

Ersetzen Sie Folgendes:

  • START_TIME: Beginn des Zeitfensters im RFC 3339-Format.
  • END_TIME: Endzeit des Zeitfensters im Format RFC 3339.

  • MAINTENANCE_RECURRENCE: eine RRULE für die Wiederholung des Wartungsfensters. Cloud Data Fusion unterstützt nur die folgenden Formate:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA oder BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Damit wird die wöchentliche Wiederholung des Fensters an den ausgewählten Tagen ab dem startTime für die angegebene Dauer festgelegt.

Weitere Informationen finden Sie unter Wartungsfenster konfigurieren.

Im folgenden Beispiel wird eine Instanz mit einem Wartungsfenster von sechs Stunden zwischen 10:00 und 16:00 Uhr (UTC) an Samstagen und Sonntagen jede Woche erstellt. Weitere Informationen finden Sie in der Instances API-Dokumentation.

// POST https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances?instanceID=example-instance

{
  "maintenancePolicy": {
      "maintenanceWindow": {
          "recurringTimeWindow": {
              "window": {
                  "startTime": "2024-01-01T10:00:00Z",
                  "endTime": "2024-01-01T16:00:00Z",
              },
              "recurrence": "FREQ=WEEKLY;BYDAY=SA,SU"
          }
      },
  }
}

gcloud

Sie können das Wartungsfenster beim Erstellen einer Instanz mit dem Befehl gcloud beta data-fusion instances create angeben.

Für ein Wartungsfenster müssen die folgenden Parameter definiert werden:

  • --maintenance-window-start legt den Beginn des Zeitfensters fest.
  • --maintenance-window-end legt das Ende des Fensters fest.
  • --maintenance-window-recurrence legt eine RRULE für die Wiederholung des Wartungsfensters fest.
gcloud beta data-fusion instances create INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --maintenance-window-start=START_TIME \
    --maintenance-window-end=END_TIME \
    --maintenance-window-recurrence=MAINTENANCE_RECURRENCE

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz.
  • PROJECT_NAME: der Name des Projekts.
  • LOCATION: der Name der Region der Instanz.
  • START_TIME: die Startzeit des Zeitraums im Eingabeformat Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert.
  • END_TIME: die Endzeit des Fensters im Eingabeformat für Datum und Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert. Das angegebene Datum und die angegebene Uhrzeit müssen nach dem Beginn liegen.

  • MAINTENANCE_RECURRENCE: eine RRULE für die Wiederholung des Wartungsfensters. Cloud Data Fusion unterstützt nur die folgenden Formate:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA oder BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Damit wird die wöchentliche Wiederholung des Fensters an den ausgewählten Tagen festgelegt, beginnend um --maintenance-window-start und für die angegebene Dauer.

Weitere Informationen finden Sie unter Wartungsfenster konfigurieren.

Mit dem folgenden Befehl wird eine Instanz mit einem Wartungsfenster von sechs Stunden zwischen 12:00 und 18:00 Uhr (UTC) an Samstagen und Sonntagen erstellt.

gcloud beta data-fusion instances create example-instance \
    --project='example-project' \
    --location='us-east1' \
    --maintenance-window-start='2024-01-01T12:00:00Z' \
    --maintenance-window-end='2024-01-01T18:00:00Z' \
    --maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'

Wartungsfenster für eine Instanz aktualisieren

Console

So aktualisieren Sie das Wartungsfenster in einer vorhandenen Instanz in der Google Cloud Console:

  1. Rufen Sie die Seite Cloud Data Fusion-Seite Instanzen auf.

    Zur Seite „VM-Instanzen“

  2. Klicken Sie auf den Instanznamen, um die Instanzdetails aufzurufen.

  3. Klicken Sie auf der Seite Instanzdetails auf das Feld Wartungsfenster und dann auf Bearbeiten.

  4. Die Felder für Wartungsfenster werden im Bearbeitungsmodus geöffnet. Aktualisieren Sie die Werte nach Bedarf:

    1. Klicken Sie auf das Kästchen Wartungsfenster aktivieren.
    2. Geben Sie im Feld Beginn eine Uhrzeit in einem unterstützten Format ein.
    3. Wählen Sie in der Liste Zeitzone eine Zeitzone aus.
    4. Wählen Sie in den Listen Tage und Dauer die Wochentage und die Dauer des Wartungsfensters aus. Weitere Informationen zu diesen Einstellungen finden Sie unter Wartungsvorgänge.

  5. Klicken Sie auf Speichern.

Weitere Informationen finden Sie unter Wartungsfenster konfigurieren.

REST API

Aktualisieren Sie die Wartungsfenster für vorhandene Instanzen mit der API-Anfrage instances.patch. Dadurch wird die vorhandene Konfiguration des Wartungsfensters überschrieben, sofern vorhanden. Andernfalls wird eine neue Konfiguration festgelegt, wie im Anfragetext angegeben.

So erstellen Sie eine API-Anfrage:

  1. Geben Sie im updateMask-Parameter die maintenance_policy-Maske an.
  2. Geben Sie im Anfragetext das Wartungsfenster in der Wartungsrichtlinienkonfiguration an:
{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

Weitere Informationen finden Sie unter Wartungsfenster konfigurieren.

Im folgenden Beispiel wird die Konfiguration der Wartungsrichtlinie der Instanz mit einem vierstündigen Wartungsfenster zwischen 11:00 und 15:00 Uhr (UTC) an jedem Freitag, Samstag und Sonntag aktualisiert.

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
"maintenancePolicy": {
  "maintenanceWindow": {
    "recurringTimeWindow": {
      "window": {
          "startTime": "2024-01-01T11:00:00Z",
          "endTime": "2024-01-01T15:00:00Z",
        },
      "recurrence": "FREQ=WEEKLY;BYDAY=FR,SA,SU"
    }
  },
}
}

gcloud

Sie können das Wartungsfenster einer Instanz mit dem Befehl gcloud beta data-fusion instances update aktualisieren.

Für ein Wartungsfenster müssen die folgenden Parameter definiert werden:

  • --maintenance-window-start legt den Beginn des Zeitfensters fest.
  • --maintenance-window-end legt das Ende des Fensters fest.
  • --maintenance-window-recurrence legt eine RRULE für die Wiederholung des Wartungsfensters fest.
gcloud beta data-fusion instances update INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --maintenance-window-start=START_TIME \
    --maintenance-window-end=END_TIME \
    --maintenance-window-recurrence=MAINTENANCE_RECURRENCE

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz.
  • PROJECT_NAME: der Name des Projekts.
  • LOCATION: der Name der Region der Instanz.
  • START_TIME: die Startzeit des Zeitraums im Eingabeformat Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert.
  • END_TIME: die Endzeit des Fensters im Eingabeformat für Datum und Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert. Das angegebene Datum und die angegebene Uhrzeit müssen nach dem Beginn liegen.

  • MAINTENANCE_RECURRENCE: eine RRULE für die Wiederholung des Wartungsfensters. Cloud Data Fusion unterstützt nur die folgenden Formate:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA oder BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Damit wird die wöchentliche Wiederholung des Fensters an den ausgewählten Tagen festgelegt, beginnend um --maintenance-window-start und für die angegebene Dauer.

Mit dem folgenden Befehl wird für die Instanz example-instance ein Wartungsfenster von sechs Stunden zwischen 12:00 und 18:00 Uhr (UTC) an Samstagen und Sonntagen festgelegt.

gcloud beta data-fusion instances update example-instance \
    --project='example-project' \
    --location='us-east1' \
    --maintenance-window-start='2024-01-01T12:00:00Z' \
    --maintenance-window-end='2024-01-01T18:00:00Z' \
    --maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'

Zeiten und Wiederholung (RRULE) für Wartungsfenster konfigurieren

Wenn Sie Start- und Endzeiten für das Wartungsfenster konfigurieren, werden die Datumskomponenten der angegebenen Zeitstempel ignoriert. Es werden nur die Tageszeit und die Dauer zwischen Start- und Endzeit berücksichtigt. Die Zeiten werden in UTC gespeichert. Sie können jedoch UTC oder den Zeitzonenoffset verwenden, wenn Sie Wartungsfenster mit der REST API oder der gcloud CLI planen.

Beachten Sie beim Konfigurieren der Wiederholung, dass RRULE an UTC-Tagen ausgerichtet ist. Passen Sie die Zeitzone daher entsprechend an, wenn sie von UTC abweicht. Wenn Ihre Zeitzone z. B. PDT (UTC-7) ist und Sie möchten, dass ein Wartungsfenster am Mittwoch um 21:00 Uhr beginnt (was Donnerstags 04:00 Uhr UTC entspricht), geben Sie in der Option BYDAY des RRULE TH anstelle von WE an.

Wartungsfenster für eine Instanz entfernen

Console

So entfernen Sie das Wartungsfenster in einer vorhandenen Instanz in der Google Cloud Console:

  1. Rufen Sie die Seite Cloud Data Fusion-Seite Instanzen auf.

    Zur Seite „VM-Instanzen“

  2. Klicken Sie auf den Instanznamen, um die Instanzdetails aufzurufen.

  3. Klicken Sie auf der Seite Instanzdetails auf das Feld Wartungsfenster und dann auf Bearbeiten.

  4. Wenn Sie das Wartungsfenster von der Instanz entfernen möchten, entfernen Sie das Häkchen aus dem Kästchen Wartungsfenster aktivieren.

  5. Klicken Sie auf Speichern.

REST API

Wenn Sie das Wartungsfenster aus einer Instanz entfernen möchten, geben Sie im Anfragetext ein leeres Wartungsrichtlinienobjekt an.

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
    "maintenancePolicy": {}
}

gcloud

Verwenden Sie den Befehl gcloud beta data-fusion instances update mit dem Flag --clear-maintenance-window, um das Wartungsfenster von einer Instanz zu entfernen.

gcloud beta data-fusion instances update INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --clear-maintenance-window

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz.
  • PROJECT_NAME: der Name des Projekts.
  • LOCATION: der Name der Region der Instanz.

Nächste Schritte