Richtlinien für VM-Verfügbarkeit festlegen


In diesem Dokument wird beschrieben, wie Sie die Verfügbarkeitsrichtlinien einer VM-Instanz (virtuelle Maschine) festlegen, um das Verhalten von VMs bei einem Wartungsereignis zu konfigurieren.

Hinweis

Beschränkungen

  • Sie können die Verfügbarkeitsrichtlinien für eine VM auf Abruf nicht ändern. Bei einem Wartungsereignis wird die VM auf Abruf beendet und nicht migriert. Sie müssen die vorzeitig beendete VM manuell neu starten.
  • Nachdem Sie eine VM mit einem E2-Maschinentyp erstellt haben, können Sie die Hostwartungseinstellungen der VM nicht mehr von Migrate in Terminate oder umgekehrt ändern.

Verfügbarkeitsrichtlinien festlegen

Sie können die Verfügbarkeitsrichtlinien einer VM ändern, wenn Sie eine VM zum ersten Mal erstellen oder nachdem die VM erstellt wurde. Verwenden Sie dazu die Methode setScheduling. Wenn Sie das Wartungsverhalten und die Einstellung für den automatischen Neustart einer VM konfigurieren möchten, verwenden Sie die Attribute onHostMaintenance und automaticRestart.

  • onHostMaintenance: legt das Verhalten bei Auftreten eines Wartungsereignisses fest, das zum Neustart der VM führen kann.

    • MIGRATE: führt dazu, dass Compute Engine die Live-Migration einer Instanz durchführt, wenn ein Wartungsereignis auftritt. Das ist der Standardwert.
    • TERMINATE: beendet eine VM, anstatt sie zu migrieren.
  • automaticRestart: bestimmt das Verhalten, wenn eine VM abstürzt oder vom System beendet wird.

    • true: Compute Engine startet eine Instanz neu, wenn sie abstürzt oder beendet wird. Das ist der Standardwert.
    • false: Compute Engine startet eine VM nicht neu, wenn die VM abstürzt oder beendet wird.

Alle VMs werden mit Standardwerten konfiguriert, es sei denn, Sie haben sie ausdrücklich anders festgelegt.

Verfügbarkeitsrichtlinie während der VM-Erstellung festlegen

Console

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

    Zur Seite „Instanz erstellen“

  2. Maximieren Sie den Bereich Netzwerk, Laufwerke, Sicherheit, Verwaltung, einzelne Mandanten und gehen Sie so vor:

    1. Maximieren Sie den Bereich Verwaltung.
    2. Wählen Sie in der Liste Automatischer Neustart die gewünschte Option aus.
    3. Wählen Sie in der Liste Bei Hostwartung die gewünschte Option aus.
  3. Klicken Sie auf Erstellen, um die VM zu erstellen.

gcloud

Verwenden Sie zur Angabe der Verfügbarkeitsrichtlinien einer neuen VM in gcloud compute das Flag --maintenance-policy, um festzulegen, ob die VM migriert oder beendet wird. Standardmäßig werden VMs automatisch neu gestartet, es sei denn, Sie geben das Flag --no-restart-on-failure an.

gcloud compute instances create VM_NAME \
    --maintenance-policy MAINTENANCE_POLICY \
    [--no-restart-on-failure]

Dabei gilt:

  • VM_NAME: der VM-Name
  • MAINTENANCE_POLICY: die Richtlinie für diese VM, entweder TERMINATE oder MIGRATE

API

Stellen Sie in der API eine POST-Anfrage an folgende URL:

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

Dabei gilt:

  • PROJECT_ID: die Projekt-ID der VM
  • ZONE: die Zone der VM

mit den Parametern onHostMaintenance und automaticRestart im Anfragetext:

    {
      "name": "example-instance",
      "description": "Front-end for real-time ingest; don't migrate.",
      ...
      // User options for influencing this VM's life cycle.
      "scheduling": {
        "onHostMaintenance": "MIGRATE",
        "automaticRestart": true
      }
    }

Weitere Informationen finden Sie in der Referenzdokumentation unter Instanzen.

Verfügbarkeitsrichtlinie für eine vorhandene VM festlegen

Console

  1. Öffnen Sie in der Google Cloud Console die Seite VM-Instanzen.

    Zu „VM-Instanzen“

  2. Klicken Sie auf die VM, deren Einstellungen Sie ändern möchten. Die Seite mit den VM-Details wird angezeigt.

  3. Führen Sie auf der Seite mit den VM-Details die folgenden Schritte aus:

    1. Klicken Sie oben auf der Seite auf Bearbeiten.
    2. Aktualisieren Sie unter Verfügbarkeitsrichtlinien die Richtlinie nach Bedarf. Im Bereich Verfügbarkeitsrichtlinien können Sie die Optionen Bei Hostwartung und Automatischer Neustart festlegen.
    3. Klicken Sie auf Speichern.

gcloud

Verwenden Sie zum Aktualisieren der Verfügbarkeitsrichtlinien einer VM den Befehl gcloud compute instances set-scheduling. Verwenden Sie dabei dieselben Parameter und Flags wie im oben gezeigten Befehl zum Erstellen einer VM:

gcloud compute instances set-scheduling VM_NAME \
    --maintenance-policy MAINTENANCE_POLICY \
    [--no-restart-on-failure | --restart-on-failure]

Dabei gilt:

  • VM_NAME: der VM-Name
  • MAINTENANCE_POLICY: die Richtlinie für diese VM, entweder TERMINATE oder MIGRATE

API

In der API können Sie eine Anfrage an die folgende URL stellen und dabei die Projekt-ID, die Zone und den VM-Namen durch Ihre eigene Projekt-ID, Zone und VM-Namen ersetzen:

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setScheduling

Der Text Ihrer Anfrage muss den neuen Wert für die Verfügbarkeitsrichtlinien enthalten:

    {
      "onHostMaintenance": "MIGRATE",
      "automaticRestart": true
    }

Weitere Informationen finden Sie in der instances().setScheduling-Referenzdokumentation.

Nächste Schritte