Host-Wartungsereignis auslösen

Auf dieser Seite wird erläutert, wie Sie ein Host-Wartungsereignis für bestimmte VM-Familieninstanzen auslösen. Mit diesem Feature können Sie manuell ein Wartungsereignis starten, um den Wartungszeitpunkt Ihrer VM zu steuern. Dies ist für Arbeitslasten nützlich, die möglicherweise von einem bestimmten Wartungsfenster betroffen sein können.

Sie können ein Wartungsereignis manuell auslösen, das sofort beginnt. Es ist nicht möglich, ein Ereignis zu einem bestimmten Datum oder einer bestimmten Uhrzeit auszulösen. Wenn Sie dieses Feature nicht verwenden, erfolgt das Wartungsereignis wie geplant.

Beschränkungen

Das Auslösen eines VM-Host-Wartungsereignisses ist auf die folgenden VM-Maschinentypen beschränkt:

Hinweise

  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.

    Select the tab for how you plan to use the samples on this page:

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-Instanzadministrator (v1) (roles/compute.instanceAdmin.v1) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen von VMs und zum Verwalten der VM-Wartung benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen von VMs und zum Verwalten der VM-Wartung erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um VMs zu erstellen und die VM-Wartung zu verwalten:

  • Um Informationen zu einer VM abzurufen: compute.instances.get
  • Um eine VM zu erstellen: compute.instances.create

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Host-Wartungsereignis auslösen

Google sendet Benachrichtigungen über bevorstehende VM-Wartungen durch mehrere Methoden. Sie finden Ihre Benachrichtigungen durch Abfrage Ihrer VMs, des Metadatenservers oder von Cloud Logging.

Nachdem Sie eine Benachrichtigung zu einem Host-Wartungsereignis erhalten haben, können Sie die Wartung sofort auslösen oder warten, bis das Wartungsereignis wie geplant stattfindet.

Wartungsereignis starten

Sie können die VM-Wartung sofort starten, anstatt auf die geplante Zeit zu warten. Verwenden Sie die Google Cloud CLI oder die REST-Methode, um die VM-Wartung sofort auszulösen.

Wenn keine Benachrichtigung vorhanden ist und Sie versuchen, ein Wartungsereignis auszulösen, wird die folgende Meldung angezeigt:

There is no reschedulable upcoming maintenance.

Dies bedeutet, dass kein Wartungsereignis geplant wurde und keine Maßnahmen erforderlich sind.

gcloud

Wenn Sie die Wartung sofort starten möchten, verwenden Sie den Befehl gcloud compute instances perform-maintenance. Sie müssen die --zone=[ZONE_NAME] angeben.

gcloud compute instances perform-maintenance VM_NAME \
--zone=ZONE

Ersetzen Sie Folgendes:

  • VM_NAME: Der Name der VM.
  • ZONE: Die Zone, in der sich die VM befindet.

Die Antwort sieht so aus:

upcomingMaintenance:{
  "canReschedule":false
  "latestWindowStartTime": "2023-12-01T19:00:01Z"
  "maintenanceStatus":"ONGOING"
  "type":"SCHEDULED"
  "windowEndTime": "2023-12-01T22:00:00Z"
  "windowStartTime": "2023-12-01T19:00:00Z"
}

In der Antwort ist maintenanceStatus auf ONGOING gesetzt. Wartungsarbeiten werden durchgeführt.

REST

Führen Sie den Befehl instances.performMaintenance aus, um die VM-Wartung auszulösen:

POST: https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME/performMaintenance

Ersetzen Sie Folgendes:

  • PROJECT_NAME ist der Name des Projekts.
  • ZONE: Die Zone, in der sich die VM befindet.
  • VM_NAME: der Name der VM

Die Antwort sieht so aus:

upcomingMaintenance:{
  "canReschedule":false
  "latestWindowStartTime": "2023-12-01T19:00:01Z"
  "maintenanceStatus":"ONGOING"
  "type":"SCHEDULED"
  "windowEndTime": "2023-12-01T22:00:00Z"
  "windowStartTime": "2023-12-01T19:00:00Z"
}

In der Antwort ist maintenanceStatus auf ONGOING gesetzt. Wartungsarbeiten werden durchgeführt.

Definitionen des Wartungsstatus

Die folgenden Statusdefinitionen erklären die Antworten auf eine VM-Wartungsabfrage. Sie enthalten Informationen zur VM-Wartung. Google Cloud CLI, REST und der Metadatenserver verwenden dieselben Antworten:

  • windowStartTime: der Beginn des Zeitfensters, in dem die Wartung durchgeführt wird
  • windowEndTime: das Ende des Zeitfensters, in dem die Wartung durchgeführt wird
  • latestWindowStartTime: der früheste Zeitpunkt, zu dem das Fenster verschoben werden kann
  • maintenanceType: der Typ der auszuführenden Wartung
    • NONE: für diese VM ist keine Wartung geplant
    • SCHEDULED: die Wartung wird 7 Tage im Voraus angekündigt
    • UNSCHEDULED: die Wartung stellt kritische Aktualisierungen dar, für die wesentlich weniger Vorankündigungen ausgegeben werden.
  • canReschedule: gibt an, ob die Wartung während des Benachrichtigungszeitraums für diese VM ausgelöst werden kann
    • TRUE: eine vom Kunden ausgelöste Wartung kann während des Benachrichtigungszeitraums ausgeführt werden
    • FALSE: eine vom Kunden ausgelöste Wartung kann für diese VM nicht ausgeführt werden. Dies tritt häufig in dem Zeitraum auf, in dem die VM gewartet wird
  • maintenanceStatus: der Status des aktuellen Wartungsvorgangs
    • ONGOING: der Wartungsvorgang wird ausgeführt
    • PENDING: der Wartungsvorgang ist geplant, wurde aber noch nicht gestartet

Verhalten des Wartungsstatus

Während Sie den Wartungsplan verwalten, prüfen Sie den Status von canReschedule= und maintenanceStatus=. Diese Antwortkombinationen beschreiben das erwartete Feature-Verhalten und zeigen eine der folgenden Statuskombinationen an:

  • Bei canReschedule=Yes und maintenanceStatus=Pending können Sie die Wartung auf der VM auslösen.
  • Bei canReschedule=No und maintenanceStatus=Ongoing wird die Wartung bereits ausgeführt.
  • Bei canReschedule=No und maintenanceStatus=Pending unterstützt Ihre VM keine manuell ausgelöste Wartung.

Nächste Schritte