In diesem Dokument wird beschrieben, wie Sie die Reparatur von ausgefallenen und fehlerhaften VMs in einer verwalteten Instanzgruppe (Managed Instance Group, MIG) deaktivieren und, falls diese bereits deaktiviert sind, die MIG so konfigurieren, dass VMs repariert werden.
Standardmäßig repariert eine verwaltete Instanzgruppe eine ausgefallene VM in der Gruppe automatisch, indem sie diese VM neu erstellt. Wenn Sie eine anwendungsbasierte Systemdiagnose konfiguriert haben, repariert die MIG auch fehlerhafte VMs, auf denen Ihre Anwendung die Systemdiagnose nicht bestanden hat. Die Reparatur einer VM, die auf einer anwendungsbasierten Systemdiagnose beruht, wird auch als automatische Reparatur bezeichnet.
Wenn Sie nicht möchten, dass eine MIG eine fehlgeschlagene oder fehlerhafte VM repariert, können Sie die Reparaturen in der MIG deaktivieren. Das Deaktivieren von Reparaturen ist in Szenarien hilfreich, in denen Sie eine ausgefallene VM beheben, Ihre eigene Reparaturlogik implementieren oder den Anwendungsstatus überwachen möchten, ohne fehlerhafte VMs zu reparieren.
Informationen dazu, ob Reparaturen in einer MIG bereits deaktiviert sind, finden Sie unter MIG auf Deaktivierung von VM-Reparaturen prüfen.
Weitere Informationen zu Reparaturen in einer MIG finden Sie unter VMs für Hochverfügbarkeit reparieren.
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 bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:
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
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
Klicken Sie auf den Namen der verwalteten Instanzgruppe, für die Sie die Reparatur deaktivieren möchten.
Klicken Sie auf Bearbeiten.
Legen Sie im Abschnitt Lebenszyklus von VM-Instanzen im Feld Standardaktion bei Fehler die Option Keine Aktion fest.
Wenn Sie die automatische Reparatur konfiguriert haben und nicht möchten, dass die MIG die automatische Reparatur deaktiviert, legen Sie im Feld Bei fehlgeschlagener Systemdiagnose die Option Instanz reparieren fest.
Klicken Sie auf Speichern.
MIG_NAME
: Name der Instanzgruppe.ZONE
: Zone, in der sich die MIG befindet Verwenden Sie bei einer regionalen MIG das Flag--region=REGION
.- Verwenden Sie für eine zonale MIG die Methode
instanceGroupManagers.patch
. - Verwenden Sie für eine regionale MIG die Methode
regionInstanceGroupManagers.patch
. - Verwenden Sie für eine zonale MIG die Methode
beta.instanceGroupManagers.patch
. - Verwenden Sie für eine regionale MIG die Methode
beta.regionInstanceGroupManagers.patch
. PROJECT_ID
: Ihre Projekt-ID.MIG_NAME
: Name der MIG.ZONE
: Die Zone, in der sich die MIG befindet. Verwenden Sie bei einer regionalen MIGregions/REGION
in der URL.Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
Klicken Sie auf den Namen der MIG, für die Sie die automatische Reparatur deaktivieren möchten.
Klicken Sie auf Bearbeiten.
Legen Sie im Abschnitt Lebenszyklus von VM-Instanzen im Feld Bei fehlgeschlagener Systemdiagnose die Option Keine Aktion fest.
Klicken Sie auf Speichern.
MIG_NAME
: Name der MIG.ZONE
: Die Zone, in der sich die MIG befindet. Verwenden Sie bei einer regionalen MIG das Flag--region=REGION
.- Verwenden Sie für eine zonale MIG die Methode
beta.instanceGroupManagers.patch
. - Verwenden Sie für eine regionale MIG die Methode
beta.regionInstanceGroupManagers.patch
. PROJECT_ID
: Ihre Projekt-ID.ZONE
: Die Zone, in der sich die MIG befindet. Verwenden Sie bei einer regionalen MIGregions/REGION
in der URL.MIG_NAME
: Name der Instanzgruppe.Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
Klicken Sie auf den Namen der verwalteten Instanzgruppe, für die Sie die Reparatur aktivieren möchten.
Klicken Sie auf Bearbeiten.
Führen Sie im Abschnitt Lebenszyklus von VM-Instanzen die folgenden Schritte aus:
- Wenn Sie ausgefallene VMs reparieren möchten, legen Sie im Feld Standardaktion bei Fehler die Option Instanz reparieren fest.
- Wenn Sie fehlerhafte VMs reparieren möchten, legen Sie im Feld Bei fehlgeschlagener Systemdiagnose die Option Instanz reparieren fest. Wenn Sie diesen Wert auf Standardaktion festlegen, wird für die automatische Fehlerbehebung dieselbe Einstellung verwendet, die Sie für das Feld Standardaktion bei einem Fehler konfigurieren.
Klicken Sie abschließend auf Speichern, um die Änderungen zu übernehmen.
MIG_NAME
durch den Namen einer MIG.default-action
ORrepair
: Wenn für die automatische Fehlerbehebung dieselbe Einstellung verwendet werden soll, die Sie für die Reparatur ausgefallener VMs konfigurieren, legen Sie den Wert aufdefault-action
fest. Wenn Sie beispielsweise die Reparatur fehlgeschlagener VMs deaktivieren, wird auch die automatische Reparatur durch die MIG deaktiviert. Wenn Sie die Reparatur fehlerhafter VMs separat steuern möchten, setzen Sie den Wert aufrepair
.- Verwenden Sie für eine zonale MIG die Methode
instanceGroupManagers.patch
. - Verwenden Sie für eine regionale MIG die Methode
regionInstanceGroupManagers.patch
. - Verwenden Sie für eine zonale MIG die Methode
beta.instanceGroupManagers.patch
. - Verwenden Sie für eine regionale MIG die Methode
beta.regionInstanceGroupManagers.patch
. PROJECT_ID
: Ihre Projekt-ID.ZONE
: Zone, in der sich die MIG befindet Verwenden Sie bei einer regionalen MIGregions/REGION
in der URL.MIG_NAME
: Name der MIG.DEFAULT_ACTION
ORREPAIR
: Wenn für die automatische Fehlerbehebung dieselbe Einstellung wie für die Reparatur fehlgeschlagener VMs verwendet werden soll, legen Sie den Wert aufDEFAULT_ACTION
fest. Wenn Sie beispielsweise die Reparatur fehlgeschlagener VMs deaktivieren, wird auch die automatische Reparatur in der MIG deaktiviert. Wenn Sie die automatische Reparatur separat konfigurieren möchten, legen Sie den Wert aufREPAIR
fest.- MIG auf Deaktivierung von VM-Reparaturen prüfen.
- Sie können die Fehler in einer fehlgeschlagenen VM untersuchen, indem Sie Instanzfehler auflisten.
- Systemzustand einer VM prüfen.
REST
Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.
Beschränkungen
Sie können Reparaturen in einer MIG nicht deaktivieren, wenn Ihre Gruppe Folgendes enthält:
Reparaturen in einer MIG deaktivieren
Wenn Sie Reparaturen in einer MIG deaktivieren, werden standardmäßig sowohl die Reparatur fehlgeschlagener VMs als auch die automatische Reparatur deaktiviert. Wenn Sie nur die automatische Reparatur deaktivieren möchten, lesen Sie den Hilfeartikel Automatische Reparatur deaktivieren.
Console
gcloud
Verwenden Sie den Befehl
update
, um Reparaturen in einer verwalteten Instanzgruppe zu deaktivieren: Dadurch wird die automatische Fehlerbehebung standardmäßig deaktiviert.gcloud compute instance-groups managed update MIG_NAME \ --default-action-on-vm-failure=do-nothing \ --zone=ZONE
Wenn die automatische Reparatur in der MIG konfiguriert ist und Sie sie nicht standardmäßig deaktivieren möchten, verwenden Sie den Befehl beta
update
, um das Flag--action-on-vm-failed-health-check
aufrepair
festzulegen. So wird sichergestellt, dass die automatische Reparatur fehlerhafter VMs auch dann funktioniert, wenn die Reparatur fehlgeschlagener VMs deaktiviert ist.gcloud beta compute instance-groups managed update MIG_NAME \ --default-action-on-vm-failure=do-nothing \ --action-on-vm-failed-health-check=repair \ --zone=ZONE
Ersetzen Sie Folgendes:
REST
So deaktivieren Sie Reparaturen in einer MIG: Dadurch wird die automatische Fehlerbehebung standardmäßig deaktiviert.
Führen Sie dazu beispielsweise den folgenden Aufruf in einer zonalen MIG aus. Dadurch wird die automatische Fehlerbehebung standardmäßig deaktiviert.
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } }
Wenn die automatische Reparatur in der MIG konfiguriert ist und Sie sie nicht standardmäßig deaktivieren möchten, verwenden Sie die API-Methoden wie unten beschrieben, um das Flag
onFailedHealthCheck
aufREPAIR
festzulegen. So wird sichergestellt, dass die automatische Reparatur fehlerhafter VMs auch dann funktioniert, wenn die Reparatur fehlgeschlagener VMs deaktiviert ist.Führen Sie beispielsweise in einer zonalen MIG den folgenden Aufruf aus:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING", "onFailedHealthCheck": "REPAIR" } }
Ersetzen Sie Folgendes:
Automatische Reparatur deaktivieren
Wenn Sie eine anwendungsbasierte Systemdiagnose in einer verwalteten Instanzgruppe konfiguriert haben und nicht möchten, dass die verwaltete Instanzgruppe fehlerhafte VMs repariert, können Sie die automatische Reparatur separat deaktivieren. Die Reparatur ausgefallener VMs wird dadurch nicht deaktiviert.
Console
gcloud
Verwenden Sie den Befehl beta
update
, um die automatische Reparatur in einer MIG zu deaktivieren, und setzen Sie das Flag--action-on-vm-failed-health-check
aufdo-nothing
.Verwenden Sie beispielsweise den folgenden Befehl für eine zonale verwaltete Instanzgruppe:
gcloud beta compute instance-groups managed update MIG_NAME \ --action-on-vm-failed-health-check=do-nothing \ --zone=ZONE
Ersetzen Sie Folgendes:
REST
Wenn Sie die automatische Reparatur in einer MIG deaktivieren möchten, verwenden Sie die API-Methoden wie unten beschrieben und setzen Sie das Flag
--action-on-vm-failed-health-check
aufdo-nothing
.Mit der folgenden Anfrage können Sie beispielsweise die automatische Reparatur in einer zonalen MIG deaktivieren:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "instanceLifecyclePolicy": { "onFailedHealthCheck": "DO_NOTHING" } }
Ersetzen Sie Folgendes:
Reparaturen oder automatische Fehlerbehebung aktivieren
Standardmäßig repariert eine verwaltete Instanzgruppe ausgefallene VMs. Wenn die automatische Reparatur konfiguriert ist, repariert die verwaltete Instanzgruppe auch fehlerhafte VMs. Wenn Sie Reparaturen oder die automatische Fehlerbehebung oder beides deaktiviert haben, können Sie sie wieder aktivieren.
Console
gcloud
Verwenden Sie den Befehl
update
, um Reparaturen in einer MIG zu aktivieren. Dadurch wird auch die automatische Fehlerbehebung aktiviert, wenn der Wert des--action-on-vm-failed-health-check
-Flagsdefault-action
ist.gcloud compute instance-groups managed update MIG_NAME \ --default-action-on-vm-failure=repair
Wenn Sie die automatische Fehlerbehebung separat deaktiviert haben und sie wieder aktivieren möchten, verwenden Sie den Befehl beta
update
:gcloud beta compute instance-groups managed update MIG_NAME \ --action-on-vm-failed-health-check=
default-action
ORrepair
Ersetzen Sie Folgendes:
REST
So aktivieren Sie Reparaturen in einer verwalteten Instanzgruppe: Dadurch wird auch die automatische Fehlerbehebung aktiviert, wenn der Wert des Felds
onFailedHealthCheck
DEFAULT_ACTION
ist.Stellen Sie beispielsweise in einer zonalen MIG die folgende Anfrage:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "defaultActionOnFailure": "REPAIR" } }
Wenn Sie die automatische Fehlerbehebung separat deaktiviert haben und sie wieder aktivieren möchten, gehen Sie so vor:
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "onFailedHealthCheck": "
DEFAULT_ACTION
ORREPAIR
" } }Ersetzen Sie Folgendes:
Nächste Schritte
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-05-13 (UTC).
-