Mit verwalteten Instanzen arbeiten

Eine verwaltete Instanzgruppe (Managed Instance Group, MIG) erstellt jede verwaltete Instanz anhand der Konfigurationskomponenten, die Sie verwenden: Instanzvorlage, optionale All-Instanz-Konfiguration und optionale zustandsorientierte Konfiguration.

Jede verwaltete Instanz ist eine Datenentität, die den gewünschten Status für eine tatsächliche VM-Instanz in einer MIG darstellt.

In diesem Dokument erfahren Sie, wie Sie zuverlässig mit den verwalteten Instanzen einer MIG arbeiten können. Sie müssen möglicherweise Informationen zu einer bestimmten Instanz hinzufügen, entfernen, aktualisieren oder abrufen.

Damit Ihre Konfigurationsänderungen nicht von der MIG rückgängig gemacht werden, ist es wichtig, dass Sie die in diesem Dokument beschriebenen Methoden verwenden. Wenn Sie außerhalb der Methoden der Gruppe arbeiten, um die VMs einer MIG zu ändern, erkennt die MIG möglicherweise nicht, dass diese VMs nicht mehr die beabsichtigte Konfiguration der Gruppe verwenden. Dies kann zu unerwarteten Ergebnissen führen. Wenn Sie beispielsweise eine VM in einer MIG mit der Instanzen-API anstelle der erforderlichen Instanzgruppenmanager-API löschen oder aktualisieren, kennt die MIG Ihre Absicht nicht. Die MIG kann diese VM dann jederzeit gemäß der Konfiguration der MIG automatisch neu erstellen oder zurücksetzen.

Hinweise

  • Prüfen Sie die Einschränkungen und create eine Gruppe.
  • 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.

      3. 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.

Was ist eine verwaltete Instanz?

Eine verwaltete Instanz ist eine Datenentität innerhalb einer verwalteten Instanzgruppe (Managed Instance Group, MIG), die den aktuellen Status und den beabsichtigten Status für eine tatsächliche VM-Instanz enthält.

Der aktuelle Status einer verwalteten Instanz umfasst die folgenden Felder:

  • Status des Lebenszyklus einer Instanz, z. B. RUNNING, STOPPING.
  • Aktuelle Aktion, die von der MIG für eine Instanz ausgeführt wird, z. B. RESTARTING, VERIFYING, NONE.
  • Status einer Instanz, z. B. HEALTHY, UNHEALTHY.

Der beabsichtigte Status einer verwalteten Instanz für eine tatsächliche VM-Instanz umfasst Folgendes:

  • Gewünschte Version, d. h. der Versionsname und die Instanzvorlage, die für die Instanz verwendet werden sollen.
  • Beibehaltener Status von Elementen (z. B. Laufwerke oder Metadaten), die beibehalten werden sollen.

Wie in Abbildung 1 dargestellt, behält die MIG für jede verwaltete Instanz in einer MIG eine tatsächliche VM bei und führt diese gemäß der Spezifikation der verwalteten Instanz aus.

Basierend auf der Konfiguration generiert die MIG automatisch verwaltete Instanzen, die den tatsächlichen VM-Instanzen entsprechen, die eine MIG in Ihrem Namen verwaltet.

Abbildung 1. Beziehung zwischen verwalteten Instanzen und zugehörigen VMs.

Informationen zu den Spezifikationen einer verwalteten Instanz finden Sie unter Informationen zu den verwalteten Instanzen in einer MIG ansehen.

Instanzen zu einer MIG hinzufügen

Sie haben verschiedene Möglichkeiten, weitere Instanzen zu einer MIG hinzuzufügen:

Wenn Sie überprüfen möchten, ob neu hinzugefügte Instanzen ausgeführt werden, überprüfen Sie den Status der Gruppe oder überprüfen Sie den Status der verwalteten Instanzen.

Manuelle Größenanpassung

Wenn eine verwaltete Instanzgruppe noch nicht für Autoscaling eingerichtet wurde, können Sie die Größe der Gruppe manuell einstellen, um die Anzahl der Instanzen in der Gruppe zu ändern. Weitere Informationen finden Sie unter Größe einer MIG manuell anpassen.

Autoscaling

Verwaltete Instanzgruppen lassen sich so konfigurieren, dass Instanzen 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. Weitere Informationen zum Autoscaling der MIG finden Sie unter Autoscaling von Instanzgruppen.

Instanzen mit bestimmten Namen hinzufügen

Wenn Sie ein System haben, das von bestimmten Namen abhängig ist, können Sie VMs mit diesen Namen einer vorhandenen MIG hinzufügen. Die Namen, die Sie diesen verwalteten Instanzen zuweisen, bleiben erhalten, wenn die VM von MIG neu erstellt wird. Weitere Informationen finden Sie unter Instanzen mit bestimmten Namen in MIGs erstellen

Weitere Informationen zum Beibehalten des Status von MIG-Instanzen finden Sie unter Zustandsorientierte MIGs.

Instanzen aus einer MIG löschen

Wenn Sie verwaltete Instanzen löschen, reduziert die MIG die targetSize der Gruppe und löscht die entsprechenden VM-Instanzen.

Wenn Sie eine zustandsorientierte MIG einrichten, löscht die MIG die beibehaltenen Zustandskonfigurationen der Instanzen. Die MIG entfernt die Instanzen auch aus allen Zielpools, denen sie angehören.

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.

So löschen Sie eine verwaltete Instanz:

VM-Konfiguration in einer MIG aktualisieren

Wenn Sie die Konfiguration von VMs in einer MIG ändern müssen, z. B. um das Bootlaufwerk oder den Maschinentyp zu ändern, Laufwerke hinzuzufügen oder andere VM-Attribute zu ändern, lesen Sie die Informationen unter VM-Konfiguration in einer MIG aktualisieren.

Instanzen in einer MIG neu erstellen

Verwenden Sie diese Methode, um ausgewählte VMs mit den neuesten VM-Konfigurationskomponenten der Gruppe zu aktualisieren. Wenn Sie alle VMs in einer verwalteten Instanzgruppe neu erstellen müssen, starten Sie stattdessen ein Rolling Update.

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.

Verwenden Sie zum Neuerstellen bestimmter Instanzen in der verwalteten Instanzgruppe die gcloud CLI oder REST.

gcloud

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

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

REST

Führen Sie in der API eine POST-Anfrage für die Methode regionInstanceGroupManagers.recreateInstances aus. Verwenden Sie für eine zonal verwaltete Instanzgruppe die Methode instanceGroupManagers.recreateInstances.

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

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

Nach einer Anfrage zum Neuerstellen von VM-Instanzen in einer verwalteten Instanzgruppe werden die neuen VMs gestartet, sobald das System sie bereitstellen kann. Je nachdem, wie viele Instanzen Sie neu erstellen lassen, kann dies einige Zeit dauern. Überprüfen Sie den Status der Gruppe oder überprüfen Sie den Status der verwalteten Instanzen.

Beim Neuerstellungsvorgang wird der Name der VM-Instanz beibehalten, der Zeitstempel der Instanzerstellung ändert sich jedoch möglicherweise nicht. Um zu prüfen, ob bei der Neuerstellung eine neue Instanz erstellt wurde, wenn sich der Zeitstempel nicht geändert hat, überprüfen Sie den Zeitstempel der Erstellung des mit dieser Instanz verknüpften Bootlaufwerks.

Informationen zu Instanzen in einer MIG abrufen

Mehr dazu finden Sie unter Informationen zu den verwalteten Instanzen in einer MIG abrufen.

Zustandsorientierte Instanzen in einer MIG konfigurieren

Siehe Zustandsorientierte MIGs konfigurieren.

Nächste Schritte