Konfigurationsupdates während der Reparatur anwenden

In diesem Dokument wird beschrieben, wie Sie Ihre verwaltete Instanzgruppe so konfigurieren, dass die neueste Instanzvorlage und instanzspezifische Konfigurationen angewendet werden, wenn eine VM während der Reparatur neu erstellt wird. Das Anwenden der neuesten verfügbaren Konfiguration während eines Reparaturvorgangs wird auch als Update während der Reparatur bezeichnet. In diesem Dokument wird auch beschrieben, wie Sie prüfen können, ob Update während der Reparatur in Ihrer verwalteten Instanzgruppe aktiviert ist und wie Sie Update während der Reparatur deaktivieren.

Standardmäßig erstellt eine verwaltete Instanzgruppe während einer Reparatur eine VM mit derselben Instanzkonfiguration neu, die ursprünglich zum Erstellen der VM verwendet wurde. Wenn Updates für die Instanzvorlage oder die instanzspezifischen Konfigurationen der Gruppe verfügbar sind, können Sie diese Änderungen auf eine reparierte VM anwenden.

Wenn Sie die Konfigurationsaktualisierungen automatisch auf alle oder eine Gruppe von VMs (PROACTIVE) oder selektiv bestimmte Instanzen (OPPORTUNISTIC) anwenden möchten, lesen Sie die Informationen unter Neue Konfigurationen auf VMs in einer verwalteten Instanzgruppe anwenden.

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 wie folgt bei Compute Engine authentifizieren.

Wählen Sie den Tab für die Verwendung der Beispiele auf dieser Seite aus:
Console

Wenn Sie über die Google Cloud Console auf Google Cloud-Dienste und -APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.
gcloud
1. Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:
```
gcloud init
```
  Hinweis: Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die neueste Version haben, indem Sie gcloud components update ausführen.
2. Legen Sie eine Standardregion und -zone fest.
REST

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

Update während der Reparatur konfigurieren

Verwenden Sie die Google Cloud Console, die gcloud CLI oder REST, um das Update bei der Reparatur zu konfigurieren.

Console

Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.

Zu den Instanzgruppen
Klicken Sie auf den Namen der verwaltete Instanzgruppe, für die Sie Update während der Reparatur konfigurieren möchten.
Klicken Sie auf Bearbeiten, um die verwaltete Instanzgruppe zu ändern.
Wählen Sie im Abschnitt VM-Instanzlebenszyklus für Update während der Reparatur der VM-Instanz die Option Instanzkonfiguration aktualisieren aus.
Klicken Sie auf Speichern.

gcloud

Verwenden Sie für eine vorhandene MIG den Befehl update:

gcloud compute instance-groups managed update MIG_NAME \
    --force-update-on-repair

Verwenden Sie für eine neue MIG den Befehl create:

gcloud compute instance-groups managed create MIG_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --force-update-on-repair

Ersetzen Sie Folgendes:

MIG_NAME: Name der Instanzgruppe.
INSTANCE_TEMPLATE: Name der Instanzvorlage, die für die Gruppe verwendet werden soll.
SIZE: Zielgröße der Instanzgruppe.

REST

Verwenden Sie für eine vorhandene zonale MIG die instanceGroupManagers.patch-Methode Oder für eine vorhandene regionale MIG dieregionInstanceGroupManagers.patch Methode

Führen Sie den folgenden Aufruf aus, um das Update bei der Reparatur in einer vorhandenen zonalen verwalteten Instanzgruppe zu konfigurieren:

PATCH https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
"instanceLifecyclePolicy":
  { "forceUpdateOnRepair": YES
  }
}

Verwenden Sie für eine neue zonale MIG die Methode instanceGroupManagers.insert oder für eine neue regionale MIG die Methode regionInstanceGroupManagers.insert.

Führen Sie beim Erstellen einer zonalen verwalteten Instanzgruppe den folgenden Aufruf aus, um Update während der Reparatur zu konfigurieren:

POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers
{
"name": "MIG_NAME",
"instanceTemplate": "INSTANCE_TEMPLATE",
"targetSize": SIZE,
"instanceLifecyclePolicy":
  { "forceUpdateOnRepair": YES
  }
}

Dabei gilt:

PROJECT_ID: Ihre Projekt-ID.
ZONE: Die Zone, in der sich die MIG befindet.
MIG_NAME: Name der Instanzgruppe.
INSTANCE_TEMPLATE: Name der Instanzvorlage, die für die Gruppe verwendet werden soll.
SIZE: Zielgröße der Instanzgruppe.

Prüfen, ob Update während der Reparatur aktiviert ist

Standardmäßig aktualisiert eine verwaltete Instanzgruppe eine VM während einer Reparatur nicht. Um zu prüfen, ob Update während der Reparatur für Ihre verwaltete Instanzgruppe aktiviert ist, verwenden Sie die Google Cloud Console, die gcloud CLI oder REST, um Update während der Reparatur aufzurufen.

Console

Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.

Zu den Instanzgruppen
Klicken Sie auf den Namen der verwaltete Instanzgruppe, für die Sie die Konfiguration prüfen möchten.
Klicken Sie auf den Tab Details.
Klicken Sie im Abschnitt VM-Instanzlebenszyklus auf die Option Updates während der Reparatur von VM-Instanzen. Wenn Instanzkonfiguration aktualisieren ausgewählt ist, ist Update während der Reparatur aktiviert.

gcloud

Verwenden Sie den Befehl describe so:

gcloud compute instance-groups managed describe MIG_NAME \
--format="(instanceLifecyclePolicy)"

Suchen Sie im Antworttext nach dem Feld forceUpdateOnRepair, das einen der folgenden Werte hat:

NO: Standard. Verwaltete Instanzgruppe aktualisiert VMs nicht, wenn sie repariert werden.
YES: Die verwaltete Instanzgruppe aktualisiert die VMs während der Reparatur.

Hier ein Beispiel für eine Ausgabe:

instanceLifecyclePolicy:
 forceUpdateOnRepair: YES

REST

Verwenden Sie für eine zonale MIG die Methode instanceGroupManagers.get oder für eine regionale MIG die Methode regionInstanceGroupManagers.get.

Verwenden Sie in einer zonalen verwalteten Instanzgruppe beispielsweise den folgenden Befehl:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

Suchen Sie im Antworttext nach dem Feld instanceLifecyclePolicy.forceUpdateOnRepair, das einen der folgenden Werte hat:

NO: Standard. Verwaltete Instanzgruppe aktualisiert VMs nicht, wenn sie repariert werden.
YES: Die verwaltete Instanzgruppe aktualisiert die VMs während der Reparatur.

Hier ist eine Beispielantwort:

{
...
"name": "example-mig",
"targetSize": 12,
...
"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "YES"
  },
...
}

Dabei gilt:

PROJECT_ID: Ihre Projekt-ID.
ZONE: Die Zone, in der sich die MIG befindet.
MIG_NAME: Name der Instanzgruppe.

Update während der Reparatur deaktivieren

Wenn Ihre verwaltete Instanzgruppe eine VM repariert und Sie möchten, dass die verwaltete Instanzgruppe die ursprüngliche Instanzvorlage oder die instanzspezifischen Konfigurationen verwendet, die zum Erstellen der VM verwendet wurden, dann müssen Sie Update während der Reparatur deaktivieren. Standardmäßig ist Update während der Reparatur für eine verwaltete Instanzgruppe deaktiviert.

Verwenden Sie die Google Cloud Console, die gcloud CLI oder REST, um das Update bei der Reparatur zu deaktivieren.

Console

Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.

Zu den Instanzgruppen
Klicken Sie auf den Namen der verwaltete Instanzgruppe, für die Sie Update während der Reparatur deaktivieren möchten.
Klicken Sie auf Bearbeiten, um die verwaltete Instanzgruppe zu ändern.
Wählen Sie im Abschnitt VM-Instanzlebenszyklus für Aktualisierungen während der Reparatur von VM-Instanzen die Option Gleiche Instanzkonfiguration beibehalten aus.
Klicken Sie auf Speichern.

gcloud

Verwenden Sie den befehl update, um das Flag --no-force-update-on-repair so festzulegen:

gcloud compute instance-groups managed update MIG_NAME \
    --no-force-update-on-repair

REST

Verwenden Sie für eine zonale MIG die Methode instanceGroupManagers.patch oder für eine regionale MIG die Methode regionInstanceGroupManagers.patch.

Verwenden Sie beispielsweise den folgenden Befehl, um die Aktualisierung für die Reparatur einer zonalen verwalteten Instanzgruppe zu deaktivieren:

PATCH https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME
{
"instanceLifecyclePolicy":
{ "forceUpdateOnRepair": NO
}
}

Dabei gilt:

PROJECT_ID: Ihre Projekt-ID.
ZONE: Die Zone, in der sich die MIG befindet.
MIG_NAME: Name der Instanzgruppe.

Nächste Schritte

Systemdiagnose für die Anwendung und automatische Reparatur einrichten
Wenn Sie eine anwendungsbasierte Systemdiagnose für Ihre MIG konfiguriert haben, beobachten Sie die Änderungen des VM-Zustands.