VMs zu einer MIG hinzufügen und daraus entfernen

---

Nachdem Sie eine verwaltete Instanzgruppe erstellt (MIG) haben, können Sie VMs zu dieser Gruppe hinzufügen oder daraus entfernen, um den Anforderungen Ihrer Arbeitslast gerecht zu werden. Wenn Sie die Standardgrenze für die maximale Anzahl von VMs, die Sie einer MIG hinzufügen können, erreicht haben und mehr VMs benötigen, können Sie die Größengrenze der MIG erhöhen.

Führen Sie folgende Schritte aus, um VMs in einer MIG hinzuzufügen oder zu entfernen:

• VMs automatisch hinzufügen oder entfernen, indem Sie die Zielgröße der MIG festlegen:
  • Automatische Skalierung für zustandslose Anwendungen
  • Größe der MIG manuell festlegen
• Bestimmte Instanzen manuell hinzufügen, entfernen oder verwerfen:
  • Instanzen mit bestimmten Namen erstellen
  • Bestimmte Instanzen löschen
  • Bestimmte Instanzen verwerfen

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.
  

  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

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  Terraform

  Wenn Sie die Terraform-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command:

     gcloud init

  3. If you're using a local shell, then create local authentication credentials for your user account:

     gcloud auth application-default login

     You don't need to do this if you're using Cloud Shell.

  Weitere Informationen unter Set up authentication for a local development environment.

  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.

Zielgröße der Gruppe festlegen

Sie können die Zielgröße einer MIG automatisch mit einem Autoscaling festlegen oder die Größe manuell festlegen.

VMs automatisch einer MIG hinzufügen und entfernen

Verwaltete Instanzgruppen lassen sich so konfigurieren, dass VMs lastabhängig automatisch hinzugefügt oder entfernt werden. So können Ihre Anwendungen ansteigenden Traffic problemlos bewältigen und Sie können Ihre Kosten senken, wenn der Bedarf an Rechenressourcen sinkt. Informationen zum Skalieren verwalteter Instanzgruppen finden Sie unter MIG mit Autoscaling erstellen.

Weitere Informationen finden Sie unter Autoscaling von Instanzgruppen.

Größe einer MIG manuell festlegen

Wenn für eine verwaltete Instanzgruppe noch keine automatische Skalierung festgelegt ist, können Sie die Größe der Gruppe manuell anpassen, um die Anzahl der Instanzen zu ändern. Wenn Sie die Gruppe vergrößern, werden gemäß der aktuellen Instanzvorlage neue Instanzen hinzugefügt. Verkleinern Sie die Gruppe, werden VMs aus der verwalteten Instanzgruppe gelöscht. Zuerst werden Instanzen mit dem currentAction-Wert DELETING, CREATING und RECREATING gelöscht, anschließend solche ohne geplante Aktionen.

Wenn die Gruppe Teil eines Backend-Dienstes ist, für den der Verbindungsausgleich aktiviert ist, kann es nach Ablauf des Verbindungsausgleichs bis zu 60 Sekunden dauern, bis die VM-Instanz entfernt oder gelöscht wird.

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie folgende Berechtigungen:

• compute.instanceGroupManagers.update für die verwaltete Instanzgruppe

Console

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

   Zu den Instanzgruppen

2. Klicken Sie in der Spalte Name der Liste auf die Instanzgruppe, deren Größe Sie anpassen möchten.

3. Klicken Sie auf Bearbeiten, um die verwaltete Instanzgruppe zu bearbeiten.

4. Geben Sie unter Anzahl der Instanzen an, wie viele Instanzen die verwaltete Instanzgruppe umfassen soll. Wenn Autoscaling aktiviert ist, werden bei Bedarf automatisch Instanzen zur Gruppe hinzugefügt oder daraus entfernt. Sie können jedoch die Werte für die Mindestzahl von Instanzen und die Maximale Anzahl von Instanzen ändern, um die Gruppengröße über das Autoscaling indirekt anzupassen.

5. Klicken Sie auf Speichern, um die neue Vorlage anzuwenden.

gcloud

Führen Sie den Befehl resize aus.

gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --zone ZONE

REST

Rufen Sie die Methode resize für eine zonale oder regionale MIG-Ressource auf. Geben Sie die neue Instanzgruppengröße als Parameter an.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resize?size=NEW_SIZE

Wenn es sich um eine regionale verwaltete Instanzgruppe handelt, ersetzen Sie zones/ZONE durch regions/REGION.

Nach einer Anfrage zur Änderung der Größe einer verwalteten Instanzgruppe, werden die VMs gestartet oder beendet, sobald das System sie bereitstellen oder löschen kann. Je nachdem, wie viele Instanzen die Gruppe umfasst, kann dies einige Zeit dauern. Prüfen Sie den Status der Instanzen in Ihrer verwalteten Instanzgruppe.

Hinweis: Da neue VMs mit der aktuellen Instanzvorlage erstellt werden, kann Ihre Gruppe voneinander abweichende VMs enthalten, wenn Sie nach Änderung der Instanzvorlage Instanzen in die Gruppe aufnehmen. Für vorhandene VMs gilt die bisherige Instanzvorlage, bis Sie sie neu erstellen, während neue VMs anhand der aktuell für die MIG angegebenen Instanzvorlage erstellt werden.

Modus für die wiederholte Erstellung während der Größenänderung deaktivieren

Beta

Für dieses Produkt gelten die „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Wenn bei der erstmaligen Erstellung einer VM-Instanz ein Fehler auftritt, versucht die verwaltete Instanzgruppe standardmäßig kontinuierlich, die VM zu erstellen, bis ihre Erstellung erfolgreich war. Wenn Sie dies verhindern möchten, können Sie den Modus für die wiederholte Erstellung deaktivieren, wenn Sie die Größe der Instanzgruppe anpassen. Dann versucht die verwaltete Instanzgruppe nur einmal, alle Instanzen zu erstellen. Wenn während der Instanzerstellung ein Fehler auftritt, gibt die verwaltete Instanzgruppe diese Instanz auf, entfernt sie aus der Liste der verwalteten Instanzen und verringert die Zielgröße der verwalteten Instanzgruppe.

Dieser Modus gilt nur für den ersten Versuch, eine VM zu erstellen. Wenn eine VM erfolgreich erstellt wurde, während dieser Modus aktiviert ist, verhält sich die VM auf dieselbe Weise wie alle anderen VMs, die durch eine reguläre Größenanpassungsanfrage erstellt wurden. Fällt eine ausgeführte VM zu einem späteren Zeitpunkt unerwartet aus und muss daher neu erstellt werden, wirkt sich der Modus nicht auf die Neuerstellung aus.

Das Deaktivieren des Modus für die wiederholte Erstellung ist besonders nützlich, wenn Systeme automatisch Gruppen von VMs erstellen, bei denen die genaue Anzahl der VMs keine große Bedeutung hat. In solchen Fällen kann es wichtiger sein, die verwaltete Instanzgruppe schnell stabil zum Laufen zu bringen, während Sie bei der Zahl der enthaltenen VMs flexibel sind. Dadurch müssen Sie nicht eine unbestimmte Zeit warten, bis alle angeforderten Instanzen erstellt wurden. Die Erstellung kann sich aufgrund von Kontingentfehlern oder anderen Problemen nämlich vorübergehend oder dauerhaft verzögern.

Beschränkungen

• Sie können Erstellungswiederholungen für eine regionale MIG mit der Zielverteilungsform EVEN nicht deaktivieren.
• Bei regionalen MIGs mit der Zielverteilungsform BALANCED oder ANY_SINGLE_ZONE müssen Sie die proaktive Umverteilung von Instanzen deaktivieren, bevor Sie den Modus für die Erstellung von Wiederholungsversuchen deaktivieren können.
• Sie können Erstellungswiederholungen für automatisch skalierte MIGs nicht deaktivieren.

Wenn Sie die Größe einer verwalteten Instanzgruppe ändern möchten und der Modus für die wiederholte Erstellung deaktiviert ist, verwenden Sie die Google Cloud CLI oder REST.

Wichtig: Google empfiehlt, nicht gleichzeitig zwei Vorgänge zur Größenänderung mit unterschiedlichen Modi für die Erstellungswiederholung auszuführen, da dies zu einer unerwarteten Zielgröße führen kann. Wenn Sie beispielsweise einen Befehl zur Größenänderung ohne Neuerstellungsversuche ausführen und vor Abschluss des Vorgangs einen zweiten Größenbefehl mit aktivierten Wiederholungsversuchen ausführen, wird der zweite Befehl durch den zweiten Befehl nicht ungültig. Einige Instanzen werden ohne Wiederholungsversuche erstellt. Wenn eine davon fehlschlägt, sinkt die Zielgröße der Gruppe entsprechend.

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen:

• compute.instanceGroupManagers.update für die verwaltete Instanzgruppe

gcloud

Verwenden Sie den Befehl resize (Beta) mit dem Flag --no-creation-retries:

gcloud beta compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --no-creation-retries \
    [--region REGION | --zone ZONE]

Dabei gilt:

• INSTANCE_GROUP_NAME: Name der MIG, deren Größe Sie anpassen möchten.
• NEW_SIZE: Zielanzahl der ausgeführten Instanzen in einer verwalteten Instanzgruppe.
• ZONE: Bei zonalen MIGs die Zone, in der sich die MIG befindet.
• REGION: Bei regionalen MIGs die Region, in der sich die MIG befindet.

REST

Verwenden Sie für eine zonale MIG die Betamethode instanceGroupManagers.resizeAdvanced oder für eine regionale MIG die Betamethode regionInstanceGroupManagers.resizeAdvanced. Geben Sie die neue Gruppengröße und das Feld noCreationRetries im Anfragetext an.

Mit dem folgenden Aufruf können Sie beispielsweise die Größe einer zonalen MIG mit deaktiviertem Erstellungswiederholungsmodus anpassen.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeAdvanced

{
 "targetSize": NEW_SIZE,
 "noCreationRetries": true
}

Dabei gilt:

• PROJECT_ID: Ihre Projekt-ID.
• ZONE: Die Zone, in der sich die MIG befindet. Ersetzen Sie bei einer regionalen MIG zones/ZONE durch regions/REGION und geben Sie die Region an. Weitere Informationen finden Sie unter Regionale MIGs.
• INSTANCE_GROUP_NAME: Name der MIG, deren Größe Sie anpassen möchten.

• NEW_SIZE: Zielanzahl der ausgeführten Instanzen in der verwalteten Instanzgruppe.

  Mit der Methode listManagedInstances können Sie herausfinden, welche Instanzen in welchem Modus erstellt werden. Wenn der Modus für die wiederholte Erstellung deaktiviert ist, haben die erstellten Instanzen einen currentAction von CREATING_WITHOUT_RETRIES.

Bestimmte Instanzen hinzufügen, entfernen oder verwerfen

Instanzen mit bestimmten Namen in MIGs erstellen

Wenn Sie ein System haben, das von bestimmten Namen abhängig ist, können Sie VMs mit spezifischen Namen einer vorhandenen MIG hinzufügen.

Die Namen, die Sie diesen verwalteten Instanzen zuweisen, bleiben erhalten, wenn die VM von der MIG neu erstellt wird. Weitere Informationen zum Beibehalten des Status von MIG-Instanzen finden Sie unter Zustandsorientierte MIGs.

Beschränkungen

Wenn Sie Instanzen mit bestimmten Namen erstellen, beachten Sie:

• Während der Instanzerstellung müssen Sie das Autoscaling deaktivieren.
• Die Aktualisierungsrichtlinie der MIG muss opportunistisch sein.
• Wenn Sie eine regionale MIG aktualisieren:
  • Sie müssen die proaktive Umverteilung von Instanzen deaktivieren.
  • Sie können die Zone, in der die VM erstellt wird, nicht auswählen.
• Sie können in einem Projekt keine doppelten VM-Instanznamen verwenden.

Sie können die gcloud CLI oder REST verwenden, um VMs mit spezifischen Namen zu einer vorhandenen MIG hinzuzufügen.

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen:

• compute.instanceGroupManagers.update für die verwaltete Instanzgruppe

gcloud

Führen Sie den Befehl instance-groups managed create-instance aus.

gcloud compute instance-groups managed create-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    [--region REGION | --zone ZONE]

Dabei gilt:

• INSTANCE_GROUP_NAME ist der Name der regionalen oder zonalen MIG, der eine neue Instanz hinzugefügt werden soll.
• INSTANCE_NAME ist der Name, den die neue Instanz haben soll.

REST

Senden Sie eine POST-Anfrage an die Methode regionInstanceGroupManagers.createInstances. Verwenden Sie für eine zonal verwaltete Instanzgruppe die Methode instanceGroupManagers.createInstances. Fügen Sie dabei in den Anfragetext das Feld instances mit den Namen einer oder mehrerer Instanzen ein.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/createInstances
{
  "instances": [
    {
      "name": "INSTANCE_NAME_1"
    },
    {
      "name": "INSTANCE_NAME_2"
    }
  ]
}

Bestimmte Instanzen aus einer Gruppe löschen

Sie können einzelne VMs aus einer verwalteten Instanzgruppe löschen. Dadurch verringert sich der angegebene Wert der Instanzgruppe für targetSize und die VMs werden aus allen Zielpools entfernt, denen sie bisher angehört haben.

Nach dem Löschen bestimmter Instanzen aus einer verwalteten Instanzgruppe gelten weiterhin die festgelegten Autoscaling-Einstellungen. Wenn Sie Instanzen aus einer Gruppe entfernen, ermittelt das Autoscaling unter Umständen eine Steigerung der Arbeitslast auf den anderen Instanzen der Gruppe und erhöht die Gruppengröße wieder auf das bisherige Niveau. Um dies zu verhindern, sollten Sie das Autoscaling beenden, bevor Sie Instanzen löschen.

Wenn die Gruppe Teil eines Backend-Dienstes ist, für den der Verbindungsausgleich aktiviert ist, kann es nach Ablauf des Verbindungsausgleichs bis zu 60 Sekunden dauern, bis die VM-Instanz entfernt oder gelöscht wird.

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen:

• compute.instanceGroupManagers.update für die verwaltete Instanzgruppe

Console

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

   Zu den Instanzgruppen

2. Klicken Sie in der Spalte Name der Liste auf die Instanzgruppe, aus der Sie einzelne Instanzen löschen möchten. Ihnen wird eine Seite mit den Attributen der Instanzgruppe und einer Liste der zur Gruppe gehörenden Instanzen angezeigt.

3. Wählen Sie im Abschnitt Mitglieder aus der Liste der Instanzen eine oder mehrere Instanzen aus, die Sie löschen möchten.

4. Klicken Sie auf Instanz löschen. Die ausgewählten Instanzen werden gelöscht.

gcloud

Verwenden Sie zum Löschen einer Instanz mit der gcloud CLI den Befehl instance-groups managed delete-instances.

gcloud compute instance-groups managed delete-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

Der Befehl gibt den Vorgangsstatus pro Instanz zurück:

• SUCCESS wird zurückgegeben, wenn die gcloud CLI die Instanz gelöscht hat.
• FAIL wird für alle Instanzen zurückgegeben, wenn eine in der Anfrage angegebene Instanz kein Mitglied der Gruppe ist, ein Mitglied bereits gelöscht oder verworfen wurde oder die Anfrage aus einem anderen Grund fehlschlägt.
• SKIPPED wird nur zurückgegeben, wenn Sie das Flag --skip-instances-on-validation-error verwenden und die Instanz kein Mitglied der Gruppe ist oder bereits gelöscht oder verworfen wurde.
• MEMBER_NOT_FOUND wird nur für regionale Gruppen zurückgegeben, wenn die gcloud CLI die Zone nicht aus dem Instanznamen auflösen konnte.

Wenn Sie davon ausgehen, dass Ihre Löschanfrage mit gleichzeitigen Vorgängen in Konflikt stehen könnte, verwenden Sie das Flag --skip-instances-on-validation-error. Dieses Flag gibt an, ob die Anfrage auch dann fortgesetzt werden soll, wenn die Anfrage Instanzen enthält, die keine Mitglieder der Gruppe sind oder bereits gelöscht oder verworfen wurden, z. B. Instanzen, die von einem Autoscaling gelöscht wurden. Wenn Sie dieses Flag weglassen und in der Anfrage eine solche Instanz angegeben ist, schlägt der Vorgang standardmäßig fehl. Der Vorgang schlägt immer fehl, wenn die Anfrage einen falsch formatierten Instanznamen oder einen Verweis auf eine Instanz in einer anderen Zone oder Region als der Zone oder Region der Gruppe enthält.

Mit dem folgenden Befehl wird beispielsweise das Löschen von vier Instanzen angefordert, von denen drei jedoch nicht mehr in der Gruppe enthalten sind:

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1 \
    --skip-instances-on-validation-error

In diesem Beispiel haben drei Instanzen die Validierung nicht bestanden, sodass sie übersprungen wurden, während example-instance-3 gelöscht wurde:

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE           INSTANCE               STATUS   VALIDATION_ERROR
example-project  us-central1-a  example-instance-1     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-1 that was already deleted.
example-project  us-central1-a  example-instance-2     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-2 that was already abandoned.
example-project  us-central1-a  example-instance-3     SUCCESS
example-project  us-central1-a  example-instance-4     SKIPPED  Cannot find instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-4.

Wenn Sie das Flag --skip-instances-on-validation-error weglassen und keine der Instanzen die Validierung besteht, wird keine Instanz gelöscht:

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE             INSTANCE              STATUS
example-project  us-central1-a    example-instance-1    FAIL
example-project  us-central1-a    example-instance-2    FAIL
example-project  us-central1-a    example-instance-3    FAIL
example-project  us-central1-a    example-instance-4    FAIL

REST

Senden Sie eine POST-Anfrage an die Methode regionInstanceGroupManagers.deleteInstances. Verwenden Sie für eine zonal verwaltete Instanzgruppe die Methode instanceGroupManagers.deleteInstances.

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

{
  "instances": [
    "zones/ZONE/instances/INSTANCE_NAME_1",
    "zones/ZONE/instances/INSTANCE_NAME_2"
   ]
}

Wenn Sie davon ausgehen, dass Ihre Löschanfrage mit gleichzeitigen Vorgängen in Konflikt stehen könnte, verwenden Sie das Feld skipInstancesOnValidationError. Dieses Feld gibt an, ob die Anfrage auch dann fortgesetzt werden soll, wenn die Anfrage Instanzen enthält, die keine Mitglieder der Gruppe sind oder bereits gelöscht oder verworfen wurden, z. B. Instanzen, die von einem Autoscaling gelöscht wurden. Wenn Sie dieses Flag weglassen und in der Anfrage eine solche Instanz angegeben ist, schlägt der Vorgang standardmäßig fehl. Der Vorgang schlägt immer fehl, wenn die Anfrage einen falsch formatierten Instanznamen oder einen Verweis auf eine Instanz in einer anderen Zone oder Region als der Zone oder Region der Gruppe enthält.

Die folgende Anfrage zum Löschen von zwei Instanzen ist beispielsweise erfolgreich, auch wenn eine der Instanzen bereits gelöscht wurde:

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

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ],
 "skipInstancesOnValidationError": true
}

Sie können sich anhand des Vorgangs die Instanzen ansehen, die im Vorgang übersprungen wurden. Verwenden Sie für regionale MIGs die Methode regionOperations.get. Verwenden Sie für zonale MIGs die Methode zoneOperations.get. Warnungen werden im Warnfeld des Vorgangs aufgelistet.

Nach einer Anfrage zum Löschen von Instanzen in einer verwalteten Instanzgruppe werden die Instanzen angehalten, sobald das System sie löschen kann. Je nachdem, wie viele Instanzen Sie aus der Gruppe löschen möchten, kann dies einige Zeit dauern. Überprüfen Sie den Status der Gruppe oder überprüfen Sie den Status der verwalteten Instanzen.

Instanzen in einer MIG verwerfen

Sie können eine VM-Instanz von einer verwalteten Instanzgruppe trennen, um Fehler daran leichter zu beheben, ohne die gesamte Gruppe in Mitleidenschaft zu ziehen. Durch das Verwerfen einer Instanz wird diese auch aus den Load-Balancern entfernt, die der verwalteten Instanzgruppe zugewiesen sind. Bestimmten Instanzen manuell zugeteilte Zielpools werden dagegen nicht entfernt.

Sie können eine verworfene VM-Instanz nicht wieder zur Gruppe hinzufügen. Das Verwerfen von Instanzen reduziert den angegebenen Wert targetSize der Instanzgruppe, ändert jedoch keine der festgelegten Autoscaling-Einstellungen. Verwaltete Instanzgruppen, für die Autoscaling eingerichtet ist, fügen weiterhin automatisch bei Bedarf Instanzen hinzu oder entfernen diese. Wenn Sie bei einer regionalen MIG mit Autoscaling im ONLY_SCALE_OUT-Modus eine VM-Instanz verwerfen, um die MIG-Zielgröße auf die empfohlene Größe des Autoscalings zu reduzieren, kann es vorkommen, dass Autoscaling eine neue VM-Instanz in der Zone der verworfenen VM erstellt. In solchen Fällen sollten Sie die VM-Instanz aus einer anderen Zone verwerfen, um das Erstellen einer neuen VM-Instanz zu vermeiden.

Wenn die Gruppe Teil eines Backend-Dienstes ist, für den der Verbindungsausgleich aktiviert ist, kann es nach Ablauf des Verbindungsausgleichs bis zu 60 Sekunden dauern, bis die VM-Instanz entfernt oder gelöscht wird.

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen:

• compute.instanceGroupManagers.update für die verwaltete Instanzgruppe

Console

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

   Zu den Instanzgruppen

2. Klicken Sie in der Spalte Name der Liste auf die Instanzgruppe, aus der Sie Instanzen entfernen möchten. Ihnen wird eine Seite mit den Attributen der Instanzgruppe und einer Liste der zur Gruppe gehörenden Instanzen angezeigt.

3. Wählen Sie im Abschnitt Mitglieder aus der Liste der Instanzen eine oder mehrere Instanzen aus, die Sie aus der Gruppe entfernen möchten.

4. Klicken Sie auf Aus Gruppe entfernen. Die ausgewählten Instanzen werden aus der Gruppe entfernt, werden aber weiterhin ausgeführt.

gcloud

Um eine Instanz aus der Instanzgruppe zu entfernen, ohne die Instanz zu löschen, verwenden Sie den Befehl instance-groups managed abandon-instances.

gcloud compute instance-groups managed abandon-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

REST

Senden Sie eine POST-Anfrage an die Methode regionInstanceGroupManagers.abandonInstances. Verwenden Sie für eine zonal verwaltete Instanzgruppe die Methode instanceGroupManagers.abandonInstances.

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

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ]
}

Nach einer Anfrage zum Verwerfen von Instanzen aus einer verwalteten Instanzgruppe werden diese so bald wie möglich aus der Gruppe entfernt. Überprüfen Sie den Status der Gruppe oder überprüfen Sie den Status der verwalteten Instanzen.

Gruppengröße erhöhen

Standardmäßig beträgt die Größenbeschränkung für eine zonale MIG 1.000 VMs und die Größenbeschränkung für eine regionale MIG 2.000 VMs. Sie können diese Limits weiter auf 2.000 VMs für eine zonale MIG und auf 4.000 VMs für eine regionale MIG erhöhen.

Zum Erhöhen der Limits legen Sie für das Feld listManagedInstancesResults der Gruppe auf PAGINATED fest. Wenn Sie noch mehr VMs in der Gruppe benötigen, erstellen Sie mehrere MIGs oder wenden Sie sich an den Support.

Achtung: Wenn Sie das Feld listManagedInstancesResults der Gruppe auf PAGINATED festlegen, ändert sich das Verhalten der Methode listManagedInstances. Bei der Standardeinstellung PAGELESS ignoriert die Listenmethode den Abfrageparameter maxResults und gibt immer alle Instanzen zurück. Bei der Einstellung PAGINATED gibt die Listenmethode paginierte Ergebnisse zurück, wobei maxResults auf 500 begrenzt ist wie bei anderen Listen in Compute Engine. Achten Sie darauf, dass alle Aufrufe dieser Methoden die Paginierung erkennen und den Abfrageparameter pageToken verwenden, um eine große Liste von Instanzen durchzugehen.

Es bestehen keine Auswirkungen auf die Google Cloud CLI oder die Google Cloud Console, die die Paginierung bereits vollständig unterstützen.

Console

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

   Zu den Instanzgruppen

2. Klicken Sie in der Spalte Name der Liste auf die Instanzgruppe, deren Größe Sie erhöhen möchten.

3. Klicken Sie auf Bearbeiten, um die Instanzgruppe zu ändern.

4. Klicken Sie auf Erweiterte Konfiguration anzeigen, um den Abschnitt "Erweiterte Einstellungen" zu maximieren.

5. Wählen Sie unter Ergebnisse der API-Aufrufliste für verwaltete Instanzen die Option Mit Seitenumbruch aus.

6. Klicken Sie auf Speichern, um die Änderungen zu übernehmen.

gcloud

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

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --list-managed-instances-results=PAGINATED

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

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --list-managed-instances-results=PAGINATED

Terraform

Wenn Sie die Größenbeschränkung einer MIG erhöhen möchten, setzen Sie das Argument list_managed_instances_results auf PAGINATED.

Im folgenden Beispiel wird die Größenbeschränkung einer zonalen MIG erhöht. Weitere Informationen zu der im Beispiel verwendeten Ressource finden Sie unter google_compute_instance_group_manager-Ressource. Verwenden Sie für eine regionale MIG die Ressource google_compute_region_instance_group_manager.

compute/zonal_mig_paginated_instances_result/main.tf

Auf GitHub ansehen Feedback

resource "google_compute_instance_group_manager" "default" {
  name                           = "my-igm"
  base_instance_name             = "test"
  target_size                    = 7
  zone                           = "us-central1-f"
  list_managed_instances_results = "PAGINATED"
  version {
    instance_template = google_compute_instance_template.default.id
    name              = "primary"
  }
}

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

REST

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

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/region/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME

{
  "listManagedInstancesResults": "PAGINATED",
}

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

Wenn Sie wieder zu den Seitenlistenergebnissen wechseln möchten, müssen Sie außerdem die Standardgrößenbeschränkung für die Gruppe wiederherstellen. Wenn Sie zurückwechseln möchten, achten Sie darauf, dass die Gruppe ihre Standardgrößenbeschränkung nicht überschreitet, und setzen Sie das Feld listManagedInstancesResults auf PAGELESS.

Nächste Schritte

• Mit verwalteten Instanzen arbeiten, z. B. Löschen, Verwerfen und Neuerstellen von Instanzen
• Informationen zu verwalteten Instanzgruppen und verwalteten Instanzen abrufen.
• Fehler bei verwalteten Instanzgruppen beheben