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.

Wartungsfenster

Ein Wartungsfenster in Cloud Data Fusion ist ein Zeitraum, in dem Sie um Wartungsvorgänge auszuführen und so das Servicerisiko zu senken. Störungen während der Spitzennutzungszeiten. 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ört die Anwendung kritischer Updates und Sicherheitspatches, um Sicherheitslücken zu mindern 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 der Wartungsfenster können bestimmte Vorgänge beeinträchtigt sein. Wir empfehlen, Wartungsfenster außerhalb der Spitzennutzungszeiten einzurichten. Die Wartungsvorgang kann sich auf Cloud Data Fusion folgendermaßen auswirken:

    • Die Benutzeroberfläche von Cloud Data Fusion Studio ist möglicherweise vorübergehend nicht verfügbar.
    • Die Pipelineausführung kann beeinträchtigt sein und einen Fehler verursachen.
    • Cloud Data Fusion-Dienste sind möglicherweise vorübergehend nicht verfügbar, wodurch API schlagen fehl.
    • 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 Edition ein. Weitere Informationen zu 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 das Kästchen Wartungsfenster aktivieren an.
    2. Geben Sie im Feld Beginn eine Uhrzeit in einem unterstützten Format ein.
    3. Wählen Sie in der Liste TimeZone eine Zeitzone aus.
    4. Wählen Sie in den Listen Tage und Länge die gewünschten Wochentage und Dauer des Zeitfensters. 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: Zeitfensterende, in das Format RFC 3339.

  • MAINTENANCE_RECURRENCE: ein RRULE für den das Wiederholungsintervall 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. Gibt die wöchentliche Wiederholung des Zeitfensters an den ausgewählten Tagen, beginnend am startTime und für die angegebene Dauer.

Weitere Informationen finden Sie unter Konfigurieren Sie die Zeiten und Wiederholungen von Wartungsfenstern (RRULE).

Im folgenden Beispiel wird eine Instanz mit einem sechsstündigen Wartungsfenster erstellt Samstag und Sonntag von 10:00 bis 16:00 Uhr (UTC) verfügbar. Weitere Informationen Weitere Informationen finden Sie in der Dokumentation zur Instanzen API.

// 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.

Die folgenden Parameter müssen für ein Wartungsfenster definiert werden:

  • --maintenance-window-start legt den Beginn des Zeitfensters fest.
  • --maintenance-window-end legt das Ende des Zeitfensters fest.
  • --maintenance-window-recurrence legt eine RRULE für das das Wiederholungsintervall des Wartungsfensters.
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 folgenden Formaten:

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

Weitere Informationen finden Sie unter Wartungsfenster konfigurieren.

Der folgende Befehl erstellt eine Instanz mit einem sechsstündigen Wartungsfenster. Samstag und Sonntag zwischen 12:00 und 18:00 Uhr UTC.

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 TimeZone 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 mithilfe der instances.patch API-Anfrage. Dadurch wird die vorhandene Konfiguration des Wartungsfensters überschrieben, wenn präsent sind. Andernfalls wird eine neue Konfiguration festgelegt, wie im Anfragetext angegeben.

Erstellen Sie wie folgt eine API-Anfrage:

  1. Geben Sie im updateMask-Parameter die maintenance_policy-Maske an.
  2. Geben Sie im Anfragetext das Wartungsfenster in der Wartung an. Richtlinienkonfiguration:
{
  "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 Zeitfensters fest.
  • --maintenance-window-recurrence legt eine RRULE für das das Wiederholungsintervall des Wartungsfensters.
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: das Ende des Fensters in der Eingabeformat für Datum/Uhrzeit. Es wird nur die angegebene Uhrzeit verwendet. Das angegebene Datum wird ignoriert. Die Datum und Uhrzeit müssen nach dem Beginn liegen.

  • MAINTENANCE_RECURRENCE: ein RRULE für den das Wiederholungsintervall des Wartungsfensters. Cloud Data Fusion unterstützt nur folgenden Formaten:

    • 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.

Der folgende Befehl aktualisiert die Instanz example-instance mit einem Wartungsfenster zwischen Samstag und Sonntag zwischen 12:00 und 18:00 Uhr (UTC) Woche.

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 von Wartungsfenstern konfigurieren (RRULE)

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.

Denken Sie beim Konfigurieren der Wiederholung daran, dass RRULE in UTC-Tagen folgt, sodass bei Abweichungen in Ihrer Zeitzone entsprechend anpassen. Beispiel: Ihre Zeitzone ist PDT (UTC-7) und Sie möchten, dass ein Wartungsfenster mittwochs um 21:00 Uhr im Ihre Zeitzone (entspricht donnerstags 4:00 Uhr UTC) und geben Sie TH an statt WE in der BYDAY-Option der RRULE.

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

Um das Wartungsfenster aus einer Instanz zu entfernen, übergeben Sie eine leere Wartung im Anfragetext.

// 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