Aktualisierungen von VM-Konfigurationen in einer MIG selektiv anwenden

In diesem Dokument wird beschrieben, wie Sie Konfigurationsaktualisierungen automatisch auf die VM-Instanzen in einer verwalteten Instanzgruppe (Managed Instance Group, MIG) anwenden.

Compute Engine verwaltet die VMs in einer MIG anhand der von Ihnen verwendeten Konfigurationskomponenten: Instanzvorlage, optionale Instanzkonfiguration und optionale zustandsorientierte Konfiguration.

Wenn Sie die VM-Konfiguration einer MIG durch Ändern dieser Komponenten aktualisieren, wendet Compute Engine die aktualisierte Konfiguration automatisch auf neue VMs an, die der Gruppe hinzugefügt werden.

Sie können eine selektive Aktualisierung einrichten, die auch als „opportunistische” Aktualisierungstyp bezeichnet wird, um eine aktualisierte Konfiguration auf vorhandene VMs anzuwenden. Diese Art der Aktualisierung bietet folgende Vorteile:

• Sie können die VMs auswählen, die Sie aktualisieren möchten.
• Sie können den Zeitpunkt und die Reihenfolge der Aktualisierungen steuern.
• Sie können die gcloud CLI oder REST verwenden, um alle VMs sofort zu aktualisieren.

Informationen zum Automatisieren des Rollouts einer neuen Konfiguration für alle oder eine zufällige Teilmenge der VMs in einer MIG finden Sie unter Aktualisierungen der VM-Konfiguration in einer MIG automatisch anwenden. Weitere Informationen finden Sie unter Methoden zum Anwenden einer neuen Konfiguration auf vorhandene VMs.

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:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

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

     gcloud init

  2. Set a default region and zone.

  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.

Aktualisierte Konfiguration auf ausgewählte VMs anwenden

Legen Sie den Aktualisierungsrichtlinientyp Ihrer Gruppe auf „opportunistisch” fest, damit die MIG keine neue VM-Konfiguration auf vorhandene VMs anwendet. Weitere Informationen finden Sie unter Aktualisierungsrichtlinien Ihrer Gruppe überprüfen.

Verwenden Sie dann die gcloud CLI oder REST, um die Konfiguration Ihrer MIG zu aktualisieren und die neueste Konfiguration auf bestimmte VMs in der Gruppe oder auf alle VMs in der Gruppe anzuwenden.

gcloud compute instance-groups managed set-instance-template INSTANCE_GROUP_NAME \
    --template=INSTANCE_TEMPLATE

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAMES \
    --most-disruptive-allowed-action DISRUPTION_LEVEL \
    --minimal-action DISRUPTION_LEVEL

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --all-instances \
    --most-disruptive-allowed-action DISRUPTION_LEVEL \
    --minimal-action DISRUPTION_LEVEL

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "updatePolicy": {
    "type": "OPPORTUNISTIC"
  },
  "versions": [{
    "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE",
  }]
}

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/applyUpdatesToInstances
{
  "instances": [
    "zones/ZONE/instances/INSTANCE_NAME_1",
    "zones/ZONE/instances/INSTANCE_NAME_2"
  ],
  "minimalAction": DISRUPTION_LEVEL,
  "mostDisruptiveAllowedAction": DISRUPTION_LEVEL
}

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/applyUpdatesToInstances
{
  "allInstances": true,
  "minimalAction": DISRUPTION_LEVEL,
  "mostDisruptiveAllowedAction": DISRUPTION_LEVEL
}

Nach einer Anfrage können Sie den Status prüfen, um festzustellen, ob die Aktualisierung abgeschlossen ist.

Unterbrechungsstufe während selektiver Aktualisierungen steuern

Je nach Art der Aktualisierung kann diese sich negativ auf den Status einer Instanz auswirken. Beispiel: Wenn Sie das Bootlaufwerk einer Instanz ändern möchten, müssen Sie die Instanz ersetzen. Um das Maß der Unterbrechung während eines selektiven Updates zu steuern, legen Sie folgende Optionen fest:

• Mindestaktion: Verwenden Sie diese Option, um Unterbrechungen so weit wie möglich zu minimieren oder um eine umfangreichere Aktion als erforderlich anzuwenden.

  • Wenn Sie Unterbrechungen so weit wie möglich einschränken möchten, legen Sie die Mindestaktion auf NONE fest. Wenn ein Update eine umfassendere Aktion erfordert, führt Compute Engine die Aktion aus, die notwendig ist, um das Update auszuführen.
  • Wenn Sie eine umfassendere Aktion anwenden möchten als notwendig, legen Sie die Mindestaktion auf RESTART oder REPLACE fest. So muss Compute Engine zum Beispiel keine VM neu starten, um die Metadaten zu ändern. Wenn Ihre Anwendung Instanzmetadaten nur beim Neustart einer VM liest, können Sie die Mindestaktion auf RESTART festlegen, um Metadatenänderungen zu übernehmen.

• Umfassendste erlaubte Aktion: Verwenden Sie diese Option, um ein Update zu verhindern, wenn dies zu einer längeren Unterbrechung führen würde, als tragbar ist. Wenn ein Update eine umfassendere Aktion erfordert, als die mit diesem Flag festgelegte, schlägt die Aktualisierungsanfrage fehl. Beispiel: Wenn Sie als umfassendste zulässige Aktion RESTART festlegen, schlägt der Versuch, das Bootlaufwerk-Image zu aktualisieren, fehl. Dieses Update erfordert eine Neuerstellung der Instanz, eine umfassendere Aktion als einen Neustart.

Beim Aktualisieren ausgewählter VMs können diese Optionen die folgenden Werte akzeptieren:

Die umfangreichste erlaubte Aktion kann nicht weniger umfangreich sein als die Mindestaktion.

Wenn Sie VMs selektiv aktualisieren, gelten folgende Standardeinstellungen:

• Die standardmäßige Mindestaktion ist NONE, wodurch Störungen so weit wie möglich eingeschränkt werden.
• Standardmäßig ist die umfassendste erlaubte Aktion REPLACE. Wenn Sie eine solche Störung nicht tolerieren können, sollten Sie die umfassendste erlaubte Aktion auf einen weniger hohen Wert setzen.

Nächste Schritte

• Informationen zu MIGs und verwalteten VMs ansehen
• Instanzvorlagen erstellen
• Mit Image-Familien und rollierenden Ersetzungen das Betriebssystem-Image auf allen VMs einer verwalteten Instanzgruppe aktualisieren.