Nach dem Erstellen oder Aktualisieren einer zustandsorientierten Konfiguration für eine zustandsorientierte verwaltete Instanzgruppe (Stateful Managed Instance Group, MIG) können Sie Folgendes tun:
- Die zustandsorientierte Konfiguration anwenden, damit sie wirksam wird.
- Die zustandsorientierte Konfiguration sowie den gültigen beibehaltenen Status von verwalteten Instanzen aufrufen.
- Die zustandsorientierte Konfiguration entfernen.
Hinweise
- Machen Sie sich damit vertraut, wann zustandsorientierte MIGs verwendet werden und wie zustandsorientierte MIGs funktionieren.
-
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Konfigurationsänderungen in einer zustandsorientierten Richtlinie werden automatisch auf alle verwalteten Instanzen angewendet.
- Konfigurationsänderungen in einer instanzspezifischen Konfiguration können manuell oder automatisch angewendet werden.
- Aktualisierte Konfigurationen selektiv auf bestimmte Instanzen anwenden: Verwenden Sie diesen Ansatz, um die Unterbrechung, den Zeitpunkt und die Reihenfolge der Aktualisierungen zu steuern.
- Aktualisierte Konfigurationen mit Rolling Updates automatisch anwenden: Verwenden Sie diesen Ansatz, um Konfigurationsänderungen automatisch auf verwaltete Instanzen anzuwenden.
- Konfigurieren Sie eine Richtlinie für opportunistische Aktualisierungen, um einen Wettbewerb mit automatischen proaktiven Aktualisierungen zu verhindern.
- Instanzspezifische Konfigurationen erstellen oder aktualisieren.
- Wenden Sie aktualisierte Konfigurationen auf bestimmte VMs an, indem Sie diese VMs selektiv aktualisieren.
- Verwenden Sie beim Erstellen oder Aktualisieren einer instanzspezifischen Konfiguration mit der gcloud CLI das Flag
--update-instance
, um die Konfiguration sofort auf die verknüpfte verwaltete Instanz anzuwenden. - Wenn Sie neue Instanzen manuell erstellen, geben Sie deren Namen und instanzspezifische Konfigurationen zum Zeitpunkt der Erstellung an. Die MIG wendet Konfigurationen sofort auf die VM-Erstellung an.
- Sie müssen die Ersatzmethode auf
RECREATE
setzen. - Sie müssen max surge auf
0
festlegen. - Bei regionalen MIGs müssen Sie die proaktive Umverteilung von Instanzen über Zonen hinweg deaktivieren.
true
: Alle Instanzkonfigurationen in der Gruppe wurden angewendet und sind wirksam oder die Gruppe hat keine Instanzkonfigurationen.false
: Die Gruppe hat mindestens eine instanzspezifische Konfiguration, die noch nicht wirksam ist: Entweder wurde sie noch nicht angewendet oder sie wird gerade angewendet.UNAPPLIED
: Die instanzspezifische Konfiguration wurde erstellt oder aktualisiert und muss auf die VM mit einer manuellen Instanzaktualisierung angewendet werden.APPLYING
: Die MIG wendet die neue oder aktualisierte instanzspezifische Konfiguration derzeit auf die VM an.EFFECTIVE
: Die instanzspezifische Konfiguration wurde erfolgreich auf die VM angewendet und ist wirksam.UNAPPLIED_DELETION
: Die instanzspezifische Konfiguration ist zum Löschen markiert. Sie müssen diese Änderung mit einer manuellen Instanzaktualisierung auf die VM anwenden, damit sie wirksam wird.DELETING
: Die Instanzkonfiguration wird gelöscht und die Änderung wird auf die VM angewendet.- Prüfen, ob eine MIG eine zustandsorientierte Konfiguration hat und ob diese Konfiguration angewendet wurde und wirksam ist
- Zustandsorientierte Konfiguration aufrufen, die für alle Instanzen in der MIG gilt und in der zustandsorientierten Richtlinie gespeichert ist
- Zustandsorientierte Konfiguration aufrufen, die für einzelne Instanzen spezifisch ist und in instanzspezifischen Konfigurationen gespeichert ist, und prüfen, ob diese Konfiguration angewendet wurde und wirksam ist
- Den gültigen beibehaltenen Status für jede Instanz in einer MIG auf der Grundlage der zustandsorientierten Richtlinie und der angewendeten instanzspezifischen Konfiguration aufrufen
hasStatefulConfig
:true
: Die Gruppe hat eine zustandsorientierte Konfiguration, d. h. eine nicht leere zustandsorientierte Richtlinie oder mindestens eine nicht leere instanzspezifische Konfiguration.false
: Es ist keine zustandsorientierte Konfiguration vorhanden.
perInstanceConfigs.allEffective
:true
: Alle Instanzkonfigurationen in der Gruppe wurden angewendet und sind wirksam oder die Gruppe hat keine Instanzkonfigurationen.false
: Die Gruppe hat mindestens eine instanzspezifische Konfiguration, die noch nicht wirksam ist: Entweder wurde sie noch nicht angewendet oder sie wird gerade angewendet.
hasStatefulConfig
:true
: Die Gruppe hat eine zustandsorientierte Konfiguration, d. h. eine nicht leere zustandsorientierte Richtlinie oder mindestens eine nicht leere instanzspezifische Konfiguration.false
: Es ist keine zustandsorientierte Konfiguration vorhanden.
perInstanceConfigs.allEffective
:true
: Alle Instanzkonfigurationen in der Gruppe wurden angewendet und sind wirksam oder die Gruppe hat keine Instanzkonfigurationen.false
: Die Gruppe hat mindestens eine instanzspezifische Konfiguration, die noch nicht wirksam ist: Entweder wurde sie noch nicht angewendet oder sie wird gerade angewendet.
Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
Klicken Sie auf den Namen der Instanzgruppe, für die Sie die zustandsorientierte Richtlinie aufrufen möchten.
Wechseln Sie zum Tab Details.
Unter Zustandsorientierte Ressourcen werden alle Ressourcen in der zustandsorientierten Richtlinie aufgeführt.
NAME
: der Name einer MIG, für die instanzspezifische Konfigurationen aufgelistet werdenPROJECT_ID
: die Projekt-ID für die Anfrage.ZONE
: die Zone, in der sich die MIG befindet (gilt für eine zonale MIG).- Ersetzen Sie bei einer regionalen MIG
zones/ZONE
durchregions/REGION
und geben Sie die Region der MIG an.
- Ersetzen Sie bei einer regionalen MIG
NAME
: der Name einer MIG, für die instanzspezifische Konfigurationen aufgelistet werdenpreservedStateFromPolicy
: Enthält den beibehaltenen Status, der anhand einer zustandsorientierten Richtlinie generiert wird, und schließt alle zustandsorientierten Konfigurationen aus, die von instanzspezifischen Konfigurationen überschrieben werden.preservedStateFromConfig
: Enthält den beibehaltenen Status, der anhand einer instanzspezifischen Konfiguration generiert wird, die bereits auf die verwaltete Instanz angewendet wurde.POLICY
: Die verwaltete Instanz hat den beibehaltenen Status auf der Grundlage einer zustandsorientierten Richtlinie.CONFIG
: Die verwaltete Instanz hat den beibehaltenen Status auf der Grundlage einer instanzspezifischen Konfiguration.- Kein Wert: Die verwaltete Instanz hat keinen Status und ist zustandslos.
INSTANCE_GROUP_NAME
: der Name einer MIG.INSTANCE_NAME
: der Name einer verwalteten Instanz in der Gruppe.- Sie haben eigenständige VMs auf eine zustandsorientierte MIG migriert und möchten nun die zustandsorientierte Konfiguration von instanzspezifischen Konfigurationen in eine gemeinsame zustandsorientierte Richtlinie verschieben.
- Sie haben Ihre Arbeitslast umstrukturiert und müssen keinen Status mehr auf den VM-Instanzen beibehalten.
- Sie haben zu Testzwecken eine zustandsorientierte Konfiguration erstellt und möchten sie jetzt bereinigen.
- Zuvor zustandsorientierte nichtflüchtige Speicher für alle VMs in einer MIG als zustandslos deklarieren
- Zuvor zustandsorientierte Netzwerkschnittstellen für alle VMs in einer MIG als zustandslos deklarieren
- Zustandsorientiertes Laufwerk von einer bestimmten VM in einer MIG trennen oder für diese als zustandslos deklarieren
- Zustandsorientierte Metadaten aus einer bestimmten VM in einer MIG entfernen
- Statische IP-Adresse von einer bestimmten VM in einer MIG trennen
- Laufwerke können anhand der Quelle, die in der Instanzvorlage definiert ist, gelöscht und neu erstellt werden.
- IP-Adressen können sich ändern.
--remove-stateful-disks
; und listen Sie die Gerätenamen aller konfigurierten zustandsorientierten Laufwerke auf.--remove-stateful-internal-ips
; und listen Sie die Namen der Netzwerkschnittstellen aller konfigurierten zustandsorientierten internen IP-Adressen auf.--remove-stateful-external-ips
; und listen Sie die Netzwerkschnittstellennamen aller konfigurierten zustandsorientierten externen IP-Adressen auf.- Löschen Sie die zugehörige instanzspezifische Konfiguration.
- Wenden Sie die Änderung auf die verwaltete Instanz an. Sie können auswählen, ob die Änderung manuell oder automatisch angewendet werden soll.
- Laufwerke können anhand ihrer Quelle in der Instanzvorlage getrennt oder neu erstellt werden.
- Metadaten werden entfernt oder auf die in der Instanzvorlage definierten Werte zurückgesetzt.
- IP-Adressen können sich ändern.
INSTANCE_GROUP_NAME
: der Name der MIG.INSTANCE_NAME
: die Namen der Instanzen, für die instanzspezifische Konfigurationen gelöscht werden sollen.MINIMAL_ACTION
: die Mindestaktion, die ausgeführt werden soll, wenn die Aktualisierung der instanzspezifischen Konfiguration auf die VM angewendet wird. Dieser Feld muss einen der folgenden Werte enthalten:- .
none
: Keine Aktion.refresh
: Aktualisierungen, die ohne das Beenden der VM angewendet werden können, werden angewendet.restart
: Die VM wird beendet und dann wieder gestartet.replace
: Die VM wird neu erstellt.
PROJECT_ID
: die Projekt-ID für die Anfrage.ZONE
: die Zone, in der sich die MIG befindet (gilt für eine zonale MIG).- Ersetzen Sie bei einer regionalen MIG
zones/ZONE
durchregions/REGION
und geben Sie die Region der MIG an.
- Ersetzen Sie bei einer regionalen MIG
INSTANCE_GROUP_NAME
: Name der MIG.INSTANCE_NAME
: die Namen der Instanzen, für die instanzspezifische Konfigurationen gelöscht werden sollen.- Zustandsorientierte MIGs konfigurieren
- Informationen zu MIGs und verwalteten Instanzen abrufen
- Mehr zu zustandsorientierten MIGs
- Informationen zu MIGs und zur Verwendung von verwalteten Instanzen
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.
Zustandsorientierte Konfiguration auf verwaltete Instanzen anwenden
Ihre zustandsorientierte Konfiguration wird wirksam, nachdem Sie oder die MIG sie angewendet haben.
Weitere konzeptionelle Informationen finden Sie unter Zustandsorientierte Konfiguration auf verwaltete Instanzen anwenden.
Konfiguration aus einer zustandsorientierten Richtlinie anwenden
Alle Konfigurationsänderungen in einer zustandsorientierten Richtlinie werden automatisch auf alle verwalteten Instanzen angewendet. Ausgeführte VM-Instanzen werden durch die Aktualisierung einer zustandsorientierten Richtlinie nicht unterbrochen.
Prüfen, ob eine zustandsorientierte Richtlinie angewendet wurde
Alle VMs prüfen
Prüfen Sie, ob die Änderungen an einer zustandsorientierten Richtlinie auf alle VMs angewendet wurden. Dies ist der Fall, wenn die MIG nach den Änderungen stabil geworden ist.
Bestimmte VMs prüfen
Prüfen Sie, ob die Änderungen an einer zustandsorientierten Richtlinie auf eine bestimmte VM in einer MIG angewendet wurden. Dazu rufen Sie den beibehaltenen Status der verwalteten Instanz auf und prüfen, ob alle Laufwerke der zustandsorientierten Richtlinie in
preservedStateFromPolicy
oderpreservedStateFromConfig
für die verwaltete Instanz vorhanden sind.Zustandsorientierte Konfiguration aus instanzspezifischen Konfigurationen anwenden
Sie können neue oder aktualisierte instanzspezifische Konfigurationen entweder manuell oder automatisch anwenden. Verwenden Sie eine der folgenden Methoden:
Bei beiden Vorgängen werden ausstehende Aktualisierungen sowohl auf instanzspezifische Konfigurationen als auch auf nicht angewendete Versionen von Instanzvorlagen angewendet, falls zutreffend.
Aktualisierte Konfiguration selektiv auf bestimmte Instanzen anwenden
Führen Sie folgende Schritte aus, um instanzspezifische Konfigurationen manuell auf bestimmte Instanzen anzuwenden:
Alternativ können Sie die folgenden Ansätze verwenden:
Aktualisierte Konfiguration mit Rolling Updates automatisch anwenden
Konfigurieren Sie proaktive Rolling Updates für Ihre MIG, um Konfigurationsaktualisierungen automatisch im rollierenden Verfahren auf die entsprechenden verwalteten Instanzen anzuwenden.
Zustandsorientierte MIGs erfordern die folgende Konfiguration für eine proaktive Aktualisierungsrichtlinie:
Mit dieser Konfiguration wird sichergestellt, dass die MIG vorhandene zustandsorientierte Instanzen neu erstellt und nicht durch andere Instanzen ersetzt.
Sie können auch dafür sorgen, dass Änderungen an instanzspezifischen Konfigurationen nach Möglichkeit angewendet werden, ohne Instanzen zu beenden. Dazu legen Sie für die Mindestaktion in der Aktualisierungsrichtlinie der Gruppe den Wert
REFRESH
fest.Prüfen, ob instanzspezifische Konfigurationen angewendet wurden
Alle instanzspezifischen Konfigurationen überprüfen
Sie können prüfen, ob alle Instanzkonfigurationen in einer MIG angewendet wurden. Rufen Sie dazu den zustandsorientierten Status der MIG ab und prüfen Sie
status.stateful.perInstanceConfigs.allEffective
:Spezifische instanzspezifische Konfiguration prüfen
Sie können prüfen, ob die Änderungen an einer bestimmten Instanzkonfiguration auf die zugehörige VM angewendet wurden. Rufen Sie dazu alle Instanzkonfigurationen auf und prüfen Sie das Feld
status
der jeweiligen Instanzkonfiguration:Zustandsorientierte Konfiguration und beibehaltenen Status anzeigen
Rufen Sie Informationen zu zustandsorientierten MIGs für die folgenden Aufgaben ab:
Status der zustandsorientierten Konfiguration einer MIG abrufen
Eine MIG gilt als zustandsorientiert, wenn sie eine zustandsorientierte Konfiguration hat, also entweder eine zustandsorientierte Richtlinie oder mindestens eine nicht leere instanzspezifische Konfiguration.
Wenn Sie eine zustandsorientierte Richtlinie erstellen, wird sie von der MIG automatisch angewendet. Wenn Sie Instanzkonfigurationen erstellen, können Sie sie später anwenden.
Wenn Sie prüfen möchten, ob eine MIG eine zustandsorientierte Konfiguration hat und alle instanzspezifischen Konfigurationen angewendet werden, rufen Sie mit der gcloud CLI oder REST den zustandsorientierten Status der MIG ab.
gcloud
Wenn Sie prüfen möchten, ob eine MIG eine zustandsorientierte Konfiguration hat, rufen Sie mit dem Befehl
gcloud compute instance-groups managed describe
den zustandsorientierten Status ab. Beispiel:gcloud compute instance-groups managed describe NAME baseInstanceName node ... name example-group ... status: isStable: true stateful: hasStatefulConfig: true perInstanceConfigs: allEffective: true versionTarget: isReached: true targetSize: 3 ...
In dieser Ausgabe gilt:
REST
Verwenden Sie die Methode
instanceGroupManagers.get
oderregionInstanceGroupManagers.get
und prüfen Sie das Feldstatus.stateful
, um zu ermitteln, ob eine MIG eine zustandsorientierte Konfiguration hat. Beispiel:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME
Die Methode gibt das Objekt
instanceGroupManagers
zurück:{ "name": "example-group", "baseInstanceName": "node", ... "status": { "isStable": true, "stateful": { "hasStatefulConfig": true, "perInstanceConfigs": { "allEffective": true } }, "versionTarget": { "isReached": true } }, "targetSize": 3, ... }
In dieser Ausgabe gilt:
Zustandsorientierte Richtlinie einer MIG abrufen
Sie können die zustandsorientierte Richtlinie einer MIG in den Details der Gruppe mit der Google Cloud Console, der gcloud CLI oder REST aufrufen.
Console
gcloud
Führen Sie den Befehl
gcloud compute instance-groups managed describe
aus, um sich die zustandsorientierte Richtlinie einer MIG anzeigen zu lassen. Beispiel:gcloud compute instance-groups managed describe NAME baseInstanceName node ... name example-group ... statefulPolicy: preservedState: disks: data-disk: autoDelete: NEVER logs-disk: autoDelete: ON_PERMANENT_INSTANCE_DELETION internalIPs: nic0: autoDelete: ON_PERMANENT_INSTANCE_DELETION externalIPs: nic0: autoDelete: NEVER status: isStable: true stateful: hasStatefulConfig: true perInstanceConfigs: allEffective: true versionTarget: isReached: true targetSize: 3 ...
REST
Um die zustandsorientierte Richtlinie einer MIG aufzurufen, verwenden Sie die Methode
instanceGroupManagers.get
oderregionInstanceGroupManagers.get
und prüfen Sie das FeldstatefulPolicy
. Beispiel:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME
Die Methode gibt das Objekt
instanceGroupManagers
zurück:{ "name": "example-group", "baseInstanceName": "node", ... "status": { "isStable": true, "versionTarget": { "isReached": true }, "stateful": { "hasStatefulConfig": true, "perInstanceConfigs": { "allEffective": true } } ... "statefulPolicy": { "preservedState": { "disks": { "data-disk": { "autoDelete": "NEVER" }, "logs-disk": { "autoDelete": "ON_PERMANENT_INSTANCE_DELETION" } }, "internalIPs": { "nic0" : { "autoDelete": "ON_PERMANENT_INSTANCE_DELETION"} }, "externalIPs": { "nic0" : { "autoDelete": "NEVER"} }, } }, "targetSize": 3, ... }
Instanzspezifische Konfigurationen einer MIG abrufen
Sie können die instanzspezifischen Konfigurationen aufrufen, indem Sie alle instanzspezifischen Konfigurationen in einer MIG auflisten. Verwenden Sie die gcloud CLI oder REST.
Wenn Sie beschließen, Instanzkonfigurationen manuell anzuwenden, wurden einige Instanzkonfigurationen möglicherweise noch nicht auf die zugehörigen Instanzen angewendet, sodass die beibehaltenen Status der Instanzen die Instanzkonfigurationen eventuell noch nicht widerspiegeln. Weitere Informationen finden Sie unter instanzspezifische Konfigurationen anwenden und Instanzkonfigurationen für einzelne Instanzen prüfen.
gcloud
Sie können alle instanzspezifischen Konfigurationen in einer MIG mit dem Befehl
gcloud compute instance-groups managed instance-configs list
auflisten:gcloud compute instance-groups managed instance-configs list NAME
Ersetzen Sie Folgendes:
Filtern Sie die Liste mit dem Standard-Flag
--filter
.So listen Sie beispielsweise alle instanzspezifischen Konfigurationen in
example-group
auf:gcloud compute instance-groups managed instance-configs list example-group --- fingerprint: JxPvsKOywuY= name: node-1 preservedState: disks: data-disk: autoDelete: NEVER mode: rw source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/disks/data-disk-1 metadata: role: primary internalIPs: nic0: ipAddress: address: /projects/example-project/regions/us-east1/addresses/node-1-int-ip autoDelete: ON_PERMANENT_INSTANCE_DELETION externalIPs: nic0: ipAddress: literal: 130.211.181.55 autoDelete: NEVER status: EFFECTIVE --- fingerprint: IbGmJBqqEkk= name: node-2 preservedState: ...
REST
Sie können alle instanzspezifischen Konfigurationen in einer MIG mit der Methode
instanceGroupManagers.listPerInstanceConfigs
oderregionInstanceGroupManagers.listPerInstanceConfigs
auflisten:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/listPerInstanceConfigs
Ersetzen Sie Folgendes:
So listen Sie beispielsweise alle instanzspezifischen Konfigurationen in
example-group
auf:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-group/listPerInstanceConfigs
Die Methode gibt die Liste der instanzspezifischen Konfigurationen in der Gruppe zurück:
{ "items": [ { "fingerprint": "JxPvsKOywuY=", "name": "node-1", "preservedState" : { "disks": { "data-disk" : { "source": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/disks/data-disk-1", "mode": "READ_WRITE", "autoDelete": "NEVER" } }, "metadata": { "role": "primary" }, "internalIPs": { "nic0" : { "ipAddress" : { "address": "/projects/example-project/regions/us-east1/addresses/node-1-int-ip" }, "autoDelete": "ON_PERMANENT_INSTANCE_DELETION" } }, "externalIPs": { "nic0": { "ipAddress" : { "literal": "54.2.3.4" }, "autoDelete": "NEVER" } } }, "status": "EFFECTIVE" }, { "fingerprint": "IbGmJBqqEkk=", "name": "node-2", "preservedState" : { ... } ... }, ... ] }
Beibehaltenen Status verwalteter Instanzen aufrufen
Wenn eine zustandsorientierte Konfiguration angewendet wird, generiert die MIG den gültigen beibehaltenen Status jeder verwalteten Instanz und legt diesen in zwei Feldern fest:
Wenn Sie den gültigen beibehaltenen Status jeder verwalteten Instanz in einer MIG aufrufen möchten, listen Sie die verwalteten Instanzen mit der gcloud CLI oder REST auf.
gcloud
Mit dem Befehl
gcloud compute instance-groups managed list-instances
und anhand der Werte in der SpaltePRESERVED_STATE
können Sie prüfen, welche verwalteten Instanzen den beibehaltenen Status haben. Beispiel:gcloud compute instance-groups managed list-instances NAME NAME ZONE STATUS HEALTH_STATE ACTION PRESERVED_STATE INSTANCE_TEMPLATE ... node-1 us-east1-c RUNNING NONE POLICY,CONFIG example-template node-2 us-east1-c RUNNING NONE POLICY,CONFIG example-template
Die Spalte
PRESERVED_STATE
kann die folgenden Werte enthalten:Mit dem Befehl
gcloud compute instance-groups managed describe-instance
können Sie den beibehaltenen Status einer bestimmten verwalteten Instanz aufrufen:gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \ --instance INSTANCE_NAME
Ersetzen Sie Folgendes:
Wenn Sie beispielsweise den beibehaltenen Status der verwalteten Instanz
node-1
inexample-group
aufrufen möchten, führen Sie den folgenden Befehl aus:gcloud compute instance-groups managed describe-instance example-group \ --instance node-1 instance: .../example-project/zones/us-east1-c/instances/node-1 instanceStatus: RUNNING currentAction: NONE id: 123456789012345678 version: instanceTemplate: .../example-project/global/instanceTemplates/example-template preservedStateFromPolicy: disks: data-disk: autoDelete: NEVER mode: rw source: .../example-project/zones/us-east1-c/disks/data-disk-1 internalIPs: nic0: ipAddress: literal: 10.0.0.1 address: .../example-project/regions/us-east1/addresses/node-1-int-ip autoDelete: ON_PERMANENT_INSTANCE_DELETION preservedStateFromConfig: metadata: role: primary my-key: my-value externalIPs: nic0: ipAddress: literal: 130.211.181.55 address: .../example-project/regions/us-east1/addresses/node-1-nat-ip autoDelete: NEVER
REST
Mit der Methode
instanceGroupManagers.listManagedInstances
oderregionInstanceGroupManagers.listManagedInstances
können Sie die verwalteten Instanzen auflisten, um sich den beibehaltenen Status der einzelnen Instanzen anzusehen.So listen Sie beispielsweise alle verwalteten Instanzen auf:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/listManagedInstances
Die Methode gibt die Liste verwalteter Instanzen in der Gruppe zurück, die Informationen zum jeweiligen beibehaltenen Status enthält:
{ "managedInstances": [ { "instance": ".../example-project/zones/us-east1-c/instances/node-1", "instanceStatus": "RUNNING", "currentAction": "NONE", "id": "123456789012345678", "version": { "instanceTemplate":".../example-project/global/instanceTemplates/example-template" }, "preservedStateFromPolicy": { "disks": { "data-disk" : { "source": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/disks/data-disk-1", "mode": "rw", "autoDelete": "NEVER" }, }, "internalIPs": { "nic0" : { "ipAddress": { "literal": "10.0.0.1", "address": "/projects/example-project/regions/us-east1/addresses/node-1-int-ip" }, "autoDelete": "ON_PERMANENT_INSTANCE_DELETION" } }, }, "preservedStateFromConfig": { "metadata": { "role": "primary", "my-key": "my-value" }, "externalIPs": { "nic0": { "ipAddress": { "literal": "130.211.181.55", "address": "/projects/example-project/regions/us-east1/addresses/node-1-nat-ip" }, "autoDelete": "NEVER" } }, } }, { "instance": ".../example-project/zones/us-east1-c/instances/node-2", "instanceStatus": "RUNNING", ... "preservedStateFromPolicy": { ... }, "preservedStateFromConfig": { ... } }, ... ] }
Verknüpfte statische IP-Adressressourcen ansehen
Um statische IP-Adressen (
Address
-Ressourcen) abzurufen, die verwalteten Instanzen in einer MIG zugewiesen sind, sehen Sie sich den beibehaltenen Status dieser Instanzen an. Statische Adressen finden Sie in den FeldernipAddress.address
.Wenn eine MIG oder die Instanzen nicht mehr vorhanden sind, die IP-Adressreservierungen aber schon, können Sie die statischen internen oder externen Adressreservierungen auflisten.
Zustandsorientierte Konfiguration entfernen
Das Entfernen einer zustandsorientierten Konfiguration ist in folgenden Szenarien hilfreich:
In diesem Abschnitt wird beschrieben, wie Sie eine zustandsorientierte Richtlinie für eine instanzspezifische Konfiguration vollständig entfernen. Wenn Sie nur einen Teil einer zustandsorientierten Richtlinie oder einer instanzspezifischen Konfiguration entfernen müssen, finden Sie in den folgenden Abschnitten weitere Informationen:
Zustandsorientierte Richtlinie entfernen
Wenn Sie eine zustandsorientierte Richtlinie entfernen, wirkt sich dies auf alle VMs in einer MIG aus. Die MIG behandelt alle zustandsorientierten Ressourcen, die in der zustandsorientierten Richtlinie konfiguriert wurden, als zustandslos, es sei denn, diese Ressourcen sind auch in instanzspezifischen Konfigurationen für einzelne Instanzen konfiguriert. Bei nachfolgenden Vorgängen zur Neuerstellung, automatischen Reparatur oder Aktualisierung können die jetzt zustandslosen Ressourcen ihren Status verlieren:
Weitere Informationen finden Sie unter Auswirkungen des Entfernens eines Laufwerks aus einer zustandsorientierten Richtlinie auf den beibehaltenen Status.
gcloud
Wenn Sie die gesamte Konfiguration aus einer zustandsorientierten Richtlinie löschen möchten, führen Sie den Befehl
gcloud compute instance-groups managed update
mit den entsprechenden Flags aus. Die entsprechenden Flags sind:Wenn Ihre zustandsorientierte Richtlinie beispielsweise die Konfiguration für zwei zustandsorientierte Laufwerke mit Gerätenamen
data-disk
undlogs-disk
enthält sowie eine Konfiguration für zustandsorientierte interne und externe IP-Adressen innerhalb der Netzwerkschnittstellenic0
, führen Sie den folgenden Befehl aus, um die Richtlinie zu löschen:gcloud compute instance-groups managed update example-group \ --zone us-east1-c \ --remove-stateful-disks data-disk,logs-disk \ --remove-stateful-internal-ips nic0 \ --remove-stateful-external-ips nic0
Die MIG entfernt aus ihrer zustandsorientierten Richtlinie die zustandsorientierte Konfiguration
data-disk
undlogs-disk
sowie die zustandsorientierte interne und externe IP-Konfiguration für die Netzwerkschnittstellenic0
. Als Ergebnis entfernt die MIG diese Laufwerke und statischen IP-Adressen automatisch und asynchron aus dem beibehaltenen Status aller verwalteten Instanzen in der Gruppe, es sei denn, die Laufwerke oder IP-Adressen sind auch in instanzspezifischen Konfigurationen konfiguriert.REST
Setzen Sie das Feld
statefulPolicy
mithilfe der MethodeinstanceGroupManagers.patch
oderregionInstanceGroupManagers.patch
aufnull
, um die gesamte Konfiguration in einer zustandsorientierten Richtlinie zu löschen. Methode.Mit dem folgenden Aufruf wird beispielsweise die zustandsorientierte Richtlinienkonfiguration entfernt:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME { "statefulPolicy": null }
Das MIG löscht die zustandsorientierte Richtlinienkonfiguration und entfernt die zustandsorientierten Ressourcen automatisch und asynchron aus dem beibehaltenen Status aller verwalteten Instanzen in der Gruppe, sofern die Ressourcen nicht auch in instanzspezifischen Konfigurationen konfiguriert sind.
Zustandsorientierte Konfiguration für eine bestimmte VM entfernen
Das Entfernen einer zustandsorientierten Konfiguration für eine bestimmte VM erfolgt in zwei Schritten:
Nach Anwendung der Änderung werden alle zustandsorientierten Elemente, die zuvor in der instanzspezifischen Konfiguration konfiguriert wurden, als zustandslos behandelt, sofern sie nicht auch in der zustandsorientierten Richtlinie der Gruppe konfiguriert sind. Wenn die VM anschließend neu erstellt oder aktualisiert wird, geht der Status der Elemente verloren:
Weitere Informationen finden Sie unter Auswirkungen der Entfernung von Elementen aus instanzspezifischen Konfigurationen auf den beibehaltenen Status.
gcloud
Führen Sie den Befehl
gcloud compute instance-groups managed instance-configs delete
aus, um die instanzspezifische Konfiguration vollständig zu löschen.Verwenden Sie das optionale Flag
--update-instance
, um die Änderungen sofort auf die Instanz anzuwenden (Standardeinstellung). Wenn Sie das Flag--no-update-instance
festlegen, werden die Änderungen bei der nächsten Neuerstellung oder Aktualisierung der Instanz angewendet.Das Flag
--instance-update-minimal-action
kann nur zusammen mit dem Flag--update-instance
verwendet werden.gcloud compute instance-groups managed instance-configs delete INSTANCE_GROUP_NAME \ --instances INSTANCE_NAME[,INSTANCE_NAME,...] \ [--no-update-instance | --update-instance] \ [--instance-update-minimal-action MINIMAL_ACTION]
Ersetzen Sie Folgendes:
Wenn Sie beispielsweise die instanzspezifische Konfiguration für
node-1
inexample-group
löschen möchten, führen Sie den folgenden Befehl aus:gcloud compute instance-groups managed instance-configs delete example-group \ --instances node-1 \ --update-instance
Die MIG löscht die instanzspezifische Konfiguration
node-1
. Da die VM aktualisiert und die Konfigurationsänderungen angewendet wurden, behandelt die MIG diese zuvor zustandsorientierten Elemente nicht mehr als zustandsorientiert.REST
Wenn Sie die instanzspezifische Konfiguration für eine oder mehrere Instanzen vollständig löschen möchten, verwenden Sie die Methode
instanceGroupManagers.deletePerInstanceConfigs
oderregionInstanceGroupManagers.deletePerInstanceConfigs
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/deletePerInstanceConfigs { "names": ["INSTANCE_NAME",...] }
Ersetzen Sie Folgendes:
Die Methode
deletePerInstanceConfig
löscht die angegebenen instanzspezifischen Konfigurationen, wendet die Änderungen jedoch nicht auf die zugehörigen VMs an. Die Änderungen werden auf eine VM angewendet, wenn Sie die Instanz neu erstellen oder aktualisieren. Aktualisieren Sie die ausgewählten VMs manuell, um die Änderungen zu übernehmen.Wenn Sie beispielsweise die instanzspezifische Konfiguration für
node-1
inexample-group
löschen möchten, rufen Sie die folgende Methode auf:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-group/deletePerInstanceConfigs { "names": ["node-1"] }
Die Methode löscht die instanzspezifische Konfiguration für die Instanz
node-1
ausexample-group
. Die Änderung wird auf die verwaltete Instanz angewendet, wenn Sie die Instanz neu erstellen oder aktualisieren.Rufen Sie die Methode
instanceGroupManagers.applyUpdatesToInstances
auf, um die Konfigurationsänderung anzuwenden:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-group/applyUpdatesToInstances { "instances": ["/zones/us-east1-c/instances/node-1"] }
Die Methode entfernt zustandsorientierte Elemente aus dem beibehaltenen Status der verwalteten Instanz.
Feedback
Wir möchten mehr über Ihre Anwendungsfälle und Herausforderungen erfahren und freuen uns über Feedback zu zustandsorientierten MIGs. Senden Sie Ihr Feedback unter mig-discuss@google.com an unser Team.
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: 2024-12-03 (UTC).
-