Attribute der Instanzvorlage mit einer instanzübergreifenden Konfiguration überschreiben

Auf dieser Seite wird beschrieben, wie Sie mithilfe einer instanzübergreifenden Konfiguration labels und metadata-Attribute für alle VM-Instanzen in einer verwalteten Instanzgruppe (Managed Instance Group, MIG) festlegen, ohne eine neue Instanzvorlage erstellen zu müssen.

Sie können Instanzvorlagen weiterhin verwenden, um Instanzattribute in einer MIG festzulegen. Die Verwendung der instanzübergreifenden Konfiguration einer MIG ist in einigen Szenarien jedoch einfacher, z. B.:

  • Sie müssen Instanzmetadaten oder -labels häufig aktualisieren, ohne jedes Mal neue Vorlagen erstellen zu müssen. Beachten Sie, dass Instanzvorlagen unveränderlich sind. Das heißt, sie können nach ihrer Erstellung nicht mehr geändert werden.

  • Sie möchten mehrere MIGs anhand einer einzigen Instanzvorlage haben, müssen aber Labels oder Metadaten für jede MIG unterschiedlich konfigurieren. Beispiel: Sie haben eine Anwendung, möchten aber verschiedene Umgebungen für Entwicklung, Tests und Produktion unterstützen. Sie können eine einzelne Instanzvorlage erstellen und für alle Umgebungen wiederverwenden, indem Sie für jede Umgebung unterschiedliche Metadaten mit einer unterschiedlichen instanzübergreifenden Konfiguration festlegen.

  • Sie haben ein Team, das für die Infrastruktur und Images zuständig ist, und ein weiteres Team, das für die Ausführung von Anwendungen zuständig ist. Ein Team kann Infrastruktur mit einer Instanzvorlage bereitstellen, das Anwendungsteam kann aber die Anwendungskonfigurationen mit instanzübergreifenden Konfigurationen verwalten.

  • Sie haben einen Agent, der auf Ihren VMs ausgeführt wird, und Sie möchten ihn mit Metadaten konfigurieren. Die Konfiguration des VM-Agents muss auch nach einer Änderung der Instanzvorlage der Gruppe beibehalten werden. Verwenden Sie die Instanzvorlage, um die Anwendungsversion zu steuern und den VM-Agent mithilfe einer instanzübergreifenden Konfiguration zu konfigurieren.

Wenn Sie dasselbe Attribut sowohl mit der Instanzvorlage der MIG als auch mit der instanzübergreifenden Konfiguration festlegen, priorisiert die MIG den Wert aus der instanzübergreifenden Konfiguration. Wenn Metadaten für enable-guest-attributes auf FALSE in der Instanzvorlage der MIG und auf TRUE in der instanzübergreifenden Konfiguration der MIG festgelegt ist, gilt Compute Engine TRUE für alle Instanzen in der Gruppe. Dadurch können Sie mit einer instanzübergreifenden Konfiguration Attribute überschreiben, die in der Instanzvorlage definiert sind.

Hinweise

  • Erstellen Sie eine verwaltete Instanzgruppe.
  • 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
    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.

      Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl: 

      gcloud init

Beschränkungen

  • Sie können die folgenden Instanzvorlagenattribute nur mit einer instanzübergreifenden Konfiguration überschreiben:

    • Metadaten
    • Labels

  • Sie können für eine instanzübergreifende Konfiguration kein Canary Update ausführen. Wenn Sie die Konfiguration auf die Gruppe anwenden, wendet Compute Engine die Attribute basierend auf Ihrer Aktualisierungsrichtlinie auf alle neuen Instanzen und auf vorhandene Instanzen an. Wenn Sie steuern möchten, welche vorhandenen Instanzen wann aktualisiert werden, können Sie selektive Aktualisierungen verwenden.

  • Wenn Sie eine zustandsorientierte Konfiguration in der MIG verwenden, können Sie nicht dasselbe Attribut in einer instanzspezifischen Konfiguration und gleichzeitig in der instanzübergreifenden Konfiguration der Gruppe festlegen.

Attribute in einer instanzübergreifenden Konfiguration festlegen

Erstellen und aktualisieren Sie die Konfiguration aller Instanzen einer MIG mit der gcloud CLI oder mit REST.

Console

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

    Zu den Instanzgruppen

  2. Wählen Sie die MIG aus, für die Sie die instanzübergreifende Konfiguration festlegen möchten.

  3. Klicken Sie auf VMs aktualisieren.

  4. Führen Sie im Abschnitt Konfiguration aller Instanzen folgende Schritte aus:

    • Klicken Sie zum Hinzufügen oder Aktualisieren von Metadatenwerten auf Metadaten verwalten. Schließen Sie die Einrichtung ab und klicken Sie auf Speichern.
    • Klicken Sie zum Hinzufügen oder Aktualisieren von Labels auf Labels verwalten. Schließen Sie die Einrichtung ab und klicken Sie auf Speichern.

  5. Nachdem Sie die Attribute in der instanzübergreifenden Konfiguration eingerichtet haben, klicken Sie auf VMs aktualisieren.

    Wenn der Updatetyp der MIG auf Automatisch festgelegt ist, wird die instanzübergreifende Konfiguration, die Sie festlegen, sofort auf alle vorhandenen VMs angewendet. Wenn der Aktualisierungstyp Selektiv ist, müssen Sie die Konfiguration selektiv auf vorhandene VMs anwenden. Weitere Informationen finden Sie unter Instanzübergreifende Konfiguration auf vorhandene VMs anwenden.

gcloud

Um eine instanzübergreifende Konfiguration hinzuzufügen oder eine vorhandene zu aktualisieren, verwenden Sie den Befehl all-instances-config update.

gcloud beta compute instance-groups managed all-instances-config update INSTANCE_GROUP_NAME \
    --metadata=KEY1=VALUE1,KEY2=VALUE2 \
    --labels=KEY3=VALUE3,KEY4=VALUE4

Dabei gilt:

  • INSTANCE_GROUP_NAME: Name der MIG.
  • KEYS und VALUES: Schlüssel/Wert-Paare für Labels oder Metadaten. Wenn der Schlüssel nicht vorhanden ist, wird er vom Aktualisierungsbefehl hinzugefügt. Die Werte vorhandener Schlüssel werden aktualisiert.

Denken Sie daran, die aktualisierte Konfiguration auf vorhandene VMs in der MIG anzuwenden.

REST

Fügen Sie eine instanzübergreifende Konfiguration hinzu oder aktualisieren Sie sie, indem Sie eine PATCH-Anfrage an eine zonale oder regionale MIG stellen.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "allInstancesConfig": {
    "properties": {
      "metadata": {
        "KEY1": "VALUE1",
        ...
      },
      "labels": {
        "KEY2": "VALUE2",
        ...
      },
    }
  }
}

Dabei gilt:

  • PROJECT_ID: Das Projekt, in dem die MIG vorhanden ist.
  • REGION: Die Region, in der sich die MIG befindet. Ersetzen Sie bei einer zonalen MIG regions/REGION durch zones/ZONE.
  • INSTANCE_GROUP_NAME: Name der MIG.
  • KEYS und VALUES: Schlüssel/Wert-Paare für Labels oder Metadaten. Wenn der Schlüssel nicht vorhanden ist, wird er von der Anfrage hinzugefügt. Bei vorhandenen Schlüsseln wird der Wert aktualisiert.

Denken Sie daran, die aktualisierte Konfiguration auf vorhandene VMs in der MIG anzuwenden.

Instanzübergreifende Konfiguration auf vorhandene VMs anwenden

Die von Ihnen für VMs in einer MIG angegebene VM-Konfiguration wird automatisch auf neue VMs angewendet, die der Gruppe hinzugefügt werden.

Mit einer der folgenden Methoden können Sie eine aktualisierte VM-Konfiguration einschließlich einer aktualisierten instanzübergreifenden Konfiguration auf vorhandene VMs in der Gruppe anwenden:

  • Automatisch (proaktiv): Verwenden Sie diese Methode, wenn die MIG neue Konfigurationen automatisch auf alle oder einen Teil der vorhandenen VMs in der Gruppe anwenden soll. Das Maß der Unterbrechung der Ausführung von VMs hängt von der konfigurierten Aktualisierungsrichtlinie ab. Sie können mit dieser Methode neue Instanzvorlagen aktualisieren. Setzen Sie den Aktualisierungstyp der MIG auf „proaktiv“, um diese Methode zu verwenden.
  • Selektiv (opportunistisch): Verwenden Sie diese Methode, wenn Sie die Aktualisierung manuell anwenden oder alle vorhandenen VMs in der Gruppe gleichzeitig aktualisieren möchten. Sie wählen eine oder alle VMs aus, die auf die neueste Konfiguration aktualisiert werden sollen. Setzen Sie den Aktualisierungstyp der MIG auf „opportunistisch“, um diese Methode zu verwenden.
  • Neuerstellung von VMs: Wenn Sie eine VM in einer MIG neu erstellen, wendet die MIG jede aktualisierte Konfiguration an, die noch nicht auf diese VM angewendet wurde. Weitere Informationen finden Sie unter VMs in einer MIG neu erstellen.

Automatisch (proaktiv)

Wenn Sie bei jeder Änderung automatisch eine aktualisierte instanzübergreifende Konfiguration aller vorhandenen VMs anwenden möchten, setzen Sie den Aktualisierungsrichtlinientyp der Gruppe auf "proaktiv". Weitere Informationen finden Sie unter Typ der automatischen (proaktiven) Aktualisierung.

Sie können die Geschwindigkeit eines proaktiven Konfigurations-Rollouts mithilfe der optionalen Einstellungen maxUnavailable, maxSurge und minReadySec steuern.

Wenn Sie proaktive Aktualisierungen verwenden möchten, müssen Sie sie nur einmal konfigurieren. Anschließend wendet die MIG alle zukünftigen Änderungen der VM-Konfiguration (Änderungen an der instanzübergreifenden Konfiguration der Gruppe, der Instanzvorlage und der instanzspezifischen Konfigurationen) automatisch auf alle VMs in der Gruppe an, basierend auf den Einstellungen in der Aktualisierungsrichtlinie der Gruppe.

Verwenden Sie die gcloud CLI oder REST, um Konfigurationsaktualisierungen automatisch anzuwenden.

gcloud

Sie können automatische (proaktive) Aktualisierungen mit dem Betabefehl update konfigurieren.

gcloud beta compute instance-groups managed update INSTANCE_GROUP_NAME \
    --update-policy-type=proactive \
    --update-policy-max-unavailable=MAX_UNAVAILABLE \
    --update-policy-max-surge=MAX_SURGE \
    --update-policy-min-ready=MIN_READY \
    --update-policy-minimal-action=MINIMAL_ACTION \
    --update-policy-replacement-method=REPLACEMENT_METHOD

Dabei gilt:

  • INSTANCE_GROUP_NAME: Name der MIG.
  • MAX_UNAVAILABLE (optional): Maximale Anzahl an Instanzen, die während der Aktualisierung nicht verfügbar sein können. Wenn Sie beispielsweise das Flag update-minimal-action auf restart setzen, wird mit diesem Flag begrenzt, wie viele VMs gleichzeitig neu gestartet werden. Dies kann eine feste Zahl (z. B. 5) oder ein Prozentsatz der Größe für die verwaltete Instanzgruppe sein (z. B. 10%).
  • MAX_SURGE (optional): Maximale Anzahl zusätzlicher Instanzen, die während der Aktualisierung erstellt werden können. Dies kann eine feste Zahl (z. B. 5) oder ein Prozentsatz der Größe für die verwaltete Instanzgruppe sein (z. B. 10%).
  • MIN_READY (optional): Mindestzeit, für die eine neu gestartete oder ersetzte VM bereit sein soll. Beispiel: 10s für 10 Sekunden. Weitere Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes.
  • MINIMAL_ACTION (optional): Aktion, die während der Konfigurationsaktualisierung für jede Instanz ausgeführt werden soll:
    • refresh: Die neue Konfiguration auf laufenden Instanzen anwenden, ohne sie neu zu starten.
    • restart: VMs werden während der Aktualisierung neu gestartet. Dies ist nützlich, wenn Ihre Anwendung Metadaten nur während des Neustarts liest.
    • replace: VMs löschen und neue erstellen, um die neue Konfiguration anzuwenden.
  • REPLACEMENT_METHOD (optional): Gibt an, welche Aktion zum Ersetzen einer Instanz verwendet wird:
    • recreate: Wartet auf das Löschen der alten Instanz und erstellt dann eine neue Instanz mit dem gleichen Namen wie die alte.
    • substitute: Erstellt eine Instanz mit einem neuen Namen, während die alte Instanz gelöscht wird

REST

Sie können automatische (proaktive) Aktualisierungen konfigurieren. Stellen Sie dazu eine PATCH-Anfrage an eine zonale oder regionale MIG.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "updatePolicy": {
    "type": "PROACTIVE",
    "maxUnavailable": {
      "percent": MAX_UNAVAILABLE
    },
    "maxSurge": {
      "percent": MAX_SURGE
    },
    "minimalAction": MINIMAL_ACTION,
    "replacementMethod": REPLACEMENT_METHOD
  }
}

Dabei gilt:

  • PROJECT_ID: Das Projekt, in dem die MIG vorhanden ist.
  • REGION: Die Region, in der sich die MIG befindet. Ersetzen Sie bei einer zonalen MIG regions/REGION durch zones/ZONE.
  • INSTANCE_GROUP_NAME: Name der MIG.
  • MAX_UNAVAILABLE (optional): Maximale Anzahl an Instanzen, die während der Aktualisierung nicht verfügbar sein können. Wenn Sie beispielsweise das Flag update-minimal-action auf RESTART setzen, wird mit diesem Flag begrenzt, wie viele VMs gleichzeitig neu gestartet werden. Dies kann ein Prozentsatz sein (z. B. "percent": 80 für 80 %) oder eine feste Zahl. Um eine feste Zahl anzugeben, ersetzen Sie "percent": MAX_UNAVAILABLE durch "fixed": MAX_UNAVAILABLE.
  • MAX_SURGE (optional): Maximale Anzahl zusätzlicher Instanzen, die während der Aktualisierung erstellt werden können. Dies kann ein Prozentsatz oder eine feste Zahl sein.
  • MINIMAL_ACTION (optional): Aktion, die während der Konfigurationsaktualisierung für jede Instanz ausgeführt werden soll:
    • REFRESH: Die neue Konfiguration auf laufenden Instanzen anwenden, ohne sie neu zu starten.
    • RESTART: VMs werden während der Aktualisierung neu gestartet. Dies ist nützlich, wenn Ihre Anwendung Metadaten nur während des Neustarts liest.
    • REPLACE: VMs löschen und neue erstellen, um die neue Konfiguration anzuwenden.
  • REPLACEMENT_METHOD (optional): Gibt an, welche Aktion zum Ersetzen einer Instanz verwendet wird:
    • RECREATE: Wartet auf das Löschen der alten Instanz und erstellt dann eine neue Instanz mit dem gleichen Namen wie die alte.
    • SUBSTITUTE: Erstellt eine Instanz mit einem neuen Namen, während die alte Instanz gelöscht wird

Wenn optionale Flags weggelassen werden, verwendet die Gruppe die Werte in der Aktualisierungsrichtlinie der Gruppe. Sie können die Aktualisierungsrichtlinie mit der gcloud CLI oder mit REST prüfen.

Selektiv (opportunistisch)

Wenn Sie steuern möchten, wann und auf welche VMs eine neue Konfiguration angewendet werden soll, setzen Sie den Aktualisierungsrichtlinientyp der Gruppe auf "opportunistisch". Weitere Informationen finden Sie unter Selektiver (opportunistischer) Aktualisierungstyp.

Wenn Sie Konfigurationsaktualisierungen selektiv anwenden, werden Änderungen an der instanzübergreifenden Konfiguration, der Instanzvorlage oder der instanzspezifischen Konfigurationen nicht automatisch auf vorhandene VMs angewendet. Sie müssen eine aktualisierte Konfiguration explizit auf vorhandene VMs anwenden, um sie zu aktualisieren.

Wenn Sie VM-Konfigurationsaktualisierungen selektiv auf VMs in einer MIG anwenden möchten, verwenden Sie die gcloud CLI oder REST.

gcloud

Sie können selektive (opportunistische) Aktualisierungen mit dem Betabefehl update konfigurieren:

gcloud beta compute instance-groups managed update INSTANCE_GROUP_NAME \
    --update-policy-type=opportunistic

Wenn Sie den Aktualisierungstyp der Gruppe auf opportunistic setzen, müssen Sie die Aktualisierung initiieren, wenn Sie die neue Konfiguration auf vorhandene VMs anwenden möchten.

Konfiguration auf bestimmte VMs anwenden

Aktualisieren Sie ausgewählte Instanzen mit dem folgenden Befehl:

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAMES \
    --minimal-action=MINIMAL_ACTION \
    --most-disruptive-allowed-action=MOST_DISRUPTIVE_ALLOWED_ACTION

Konfiguration auf alle VMs anwenden

Aktualisieren Sie alle vorhandenen Instanzen mit dem folgenden Befehl:

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --all-instances \
    --minimal-action=MINIMAL_ACTION \
    --most-disruptive-allowed-action=MOST_DISRUPTIVE_ALLOWED_ACTION

Dabei gilt:

  • INSTANCE_GROUP_NAME: Name der MIG.
  • INSTANCE_NAMES: Eine Liste der Instanzen, auf die die Vorlage angewendet werden soll.
  • MINIMAL_ACTION (optional): Aktion, die während der Konfigurationsaktualisierung für jede Instanz ausgeführt werden soll:
    • refresh (Standardeinstellung): Die neue Konfiguration wird auf laufenden Instanzen angewendet, ohne sie neu zu starten.
    • restart: VMs werden während der Aktualisierung neu gestartet. Dies ist nützlich, wenn Ihre Anwendung Metadaten nur während des Neustarts liest.
    • replace: VMs löschen und neue erstellen, um die neue Konfiguration anzuwenden.
  • MOST_DISRUPTIVE_ALLOWED_ACTION (optional): Führen Sie höchstens diese Aktion für jede Instanz aus. Wenn die Konfigurationsaktualisierung eine umfangreichere Aktion erfordert, als hier angegeben, schlägt die Aktualisierung fehl und es werden keine Änderungen vorgenommen.
    • none: Keine Aktion
    • refresh: Die neue Konfiguration wird ohne Beenden von Instanzen angewendet, sofern möglich. Verwenden Sie beispielsweise refresh, um Änderungen anzuwenden, die sich nur auf Metadaten oder zusätzliche Laufwerke auswirken.
    • restart: Die neue Konfiguration wird ohne Ersetzen von Instanzen angewendet, sofern möglich. Beispielsweise ist das Beenden und erneute Starten von Instanzen ausreichend, um Änderungen am Maschinentyp anzuwenden.
    • replace: Alte Instanzen werden gemäß dem Flag --replacement-method ersetzt.

REST

Sie können selektive (opportunistische) Aktualisierungen konfigurieren. Stellen Sie dazu eine PATCH-Anfrage an eine zonale oder regionale MIG.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "updatePolicy": {
    "type": "OPPORTUNISTIC"
}

Wenn Sie den Aktualisierungstyp der Gruppe auf OPPORTUNISTIC setzen, müssen Sie die Aktualisierung initiieren, wenn Sie die neue Konfiguration auf vorhandene VMs anwenden möchten.

Konfiguration auf bestimmte VMs anwenden

Verwenden Sie die folgende Anfrage, um bestimmte Instanzen zu aktualisieren:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/applyUpdatesToInstances

{
  "instances": [
    "zones/ZONE/instances/INSTANCE_NAME_1",
    "zones/ZONE/instances/INSTANCE_NAME_2"
  ],
  "minimalAction": MINIMAL_ACTION,
  "mostDisruptiveAllowedAction": MOST_DISRUPTIVE_ALLOWED_ACTION
}

Konfiguration auf alle VMs anwenden

Verwenden Sie die folgende Anfrage, um alle vorhandenen Instanzen zu aktualisieren:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/applyUpdatesToInstances

{
  "allInstances": true,
  "minimalAction": MINIMAL_ACTION,
  "mostDisruptiveAllowedAction": MOST_DISRUPTIVE_ALLOWED_ACTION
}

Dabei gilt:

  • PROJECT_ID: Das Projekt, in dem die MIG vorhanden ist.
  • REGION: Die Region, in der sich die MIG befindet. Ersetzen Sie bei einer zonalen MIG regions/REGION durch zones/ZONE.
  • INSTANCE_GROUP_NAME: Name der MIG.
  • MINIMAL_ACTION (optional): Aktion, die während der Konfigurationsaktualisierung für jede Instanz ausgeführt werden soll:
    • REFRESH: Die neue Konfiguration auf laufenden Instanzen anwenden, ohne sie neu zu starten.
    • RESTART: VMs werden während der Aktualisierung neu gestartet. Dies ist nützlich, wenn Ihre Anwendung Metadaten nur während des Neustarts liest.
    • REPLACE: VMs löschen und neue erstellen, um die neue Konfiguration anzuwenden.
  • MOST_DISRUPTIVE_ALLOWED_ACTION (optional): Führen Sie höchstens diese Aktion für jede Instanz aus. Wenn die Konfigurationsaktualisierung eine umfangreichere Aktion erfordert, als hier angegeben, schlägt die Aktualisierung fehl und es werden keine Änderungen vorgenommen.
    • NONE: Keine Aktion
    • REFRESH: Die neue Konfiguration wird ohne Beenden von Instanzen angewendet, sofern möglich. Verwenden Sie beispielsweise REFRESH, um Änderungen anzuwenden, die sich nur auf Metadaten oder zusätzliche Laufwerke auswirken.
    • RESTART: Die neue Konfiguration wird ohne Ersetzen von Instanzen angewendet, sofern möglich. Beispielsweise ist das Beenden und erneute Starten von Instanzen ausreichend, um Änderungen am Maschinentyp anzuwenden.
    • REPLACE: Ersetzen Sie alte Instanzen gemäß dem Feld updatePolicy.replacementMethod der Gruppe.

Prüfen, ob eine instanzübergreifende Konfiguration angewendet wurde

Sie können mit einer der folgenden Methoden prüfen, ob die neueste instanzübergreifende Konfiguration auf alle VMs in der Gruppe angewendet wurde.

Console

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

    Zu den Instanzgruppen

  2. Wählen Sie die MIG aus, für die Sie die instanzübergreifende Konfiguration aufrufen möchten.

  3. Wechseln Sie zum Tab Details.

  4. Wenn die neueste instanzübergreifende Konfiguration auf alle VMs angewendet wird, müssen im Bereich Konfiguration aller Instanzen inZuletzt geändert und Status diese Werte enthalten sein:

    • Zuletzt geändert: Zeigt die Zeit an, zu der Sie die instanzübergreifende Konfiguration auf alle VMs angewendet haben.
    • Status: Zeigt Auf alle VMs angewendet an. Wenn die Instanzen nicht auf alle VMs angewendet werden, wird der Status als Ausstehende VM-Aktualisierung angezeigt.

gcloud

Verwenden Sie den Befehl describe (Beta) und fügen Sie das Flag --format ein, um nach dem Wert status.allInstancesConfig.effective zu suchen.

gcloud beta compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --format="(status.allInstancesConfig)"

Beispielausgabe:

status:
  allInstancesConfig:
    currentRevision: 2022-12-02T10:30:15.012345Z
    effective: true

Wenn der Wert effective auf true festgelegt ist, wird die neueste Konfiguration auf alle VMs angewendet. Der Wert currentRevision zeigt den Zeitstempel der letzten Änderung an der instanzübergreifenden Konfiguration der Gruppe an.

Wenn der Wert effective auf false festgelegt ist, wird die neueste Konfiguration noch nicht auf alle VMs angewendet.

Wenn Sie den Status der einzelnen VMs prüfen möchten, können Sie alle VMs der MIG auflisten oder jede VM einzeln mit dem Befehl Betadescribe-instance prüfen:

gcloud beta compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME

Beispielausgabe:

allInstancesConfig:
  revision: 2022-12-02T10:30:15.012345Z
currentAction: NONE
id: '8393021473297481188'
instance: .../projects/PROJECT/zones/ZONE/instances/INSTANCE_NAME
instanceStatus: RUNNING
name: INSTANCE_NAME
version:
  instanceTemplate: .../projects/PROJECT/global/instanceTemplates/INSTANCE_TEMPLATE

Wenn Sie sehen möchten, welche VMs die neueste Konfiguration haben, vergleichen Sie den Zeitstempel revision auf jeder VM mit dem Zeitstempel currentRevision in der MIG.

REST

Senden Sie eine GET-Anfrage an die zonale oder regionale MIG, um den Wert des Flags status.allInstancesConfig.effective zu prüfen.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

Beispielantwort:

{
  ...
  "status": {
    "isStable": "true",
    "versionTarget": {
      "isReached": "true"
    },
    "allInstancesConfig": {
      "currentRevision": "2022-12-02T10:30:15.012345Z",
      "effective": "true"
    },
  ...
  },
  ...
}

Wenn das Feld effective auf true festgelegt ist, wird die neueste Konfiguration auf alle VMs angewendet. Das Feld currentRevision zeigt den Zeitstempel der letzten Änderung an der instanzübergreifenden Konfiguration der Gruppe an.

Wenn das Feld effective auf false gesetzt ist, wird die neueste Konfiguration noch nicht auf alle VMs angewendet.

Um den Status der einzelnen Instanzen zu prüfen, listen Sie verwaltete Instanzen für die zonale oder regionale MIG auf:

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

Beispielausgabe:

{
  "managedInstances": [
    ...
    {
      "instance": ".../zones/ZONE/instances/INSTANCE_NAME",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "allInstancesConfig": {
        "revision": "2022-12-02T10:30:15.012345Z"
      },
      "version": {
        "name": "V1",
        "instanceTemplate": ".../projects/.../instanceTemplates/INSTANCE_TEMPLATE"
      }
    },
    {
      ...
    }
  ]
}

Wenn Sie sehen möchten, welche VMs die neueste Konfiguration haben, vergleichen Sie den Zeitstempel revision auf jeder VM mit dem Zeitstempel currentRevision in der MIG.

Attribute in einer instanzübergreifenden Konfiguration auflisten

Eine instanzübergreifende Konfiguration ist Teil der Konfiguration der MIG. Verwenden Sie eine der folgenden Methoden, um die Konfiguration der gesamten Instanz zu prüfen.

Console

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

    Zu den Instanzgruppen

  2. Wählen Sie die MIG aus, für die Sie die instanzübergreifende Konfiguration aufrufen möchten.

  3. Wechseln Sie zum Tab Details.

  4. Weitere Informationen finden Sie im Abschnitt Konfiguration aller Instanzen.

gcloud

Verwenden Sie den Befehl describe und fügen Sie das Flag --format ein, um den Wert der instanzübergreifenden Konfiguration der Gruppe anzuzeigen.

gcloud beta compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --format="(allInstancesConfig)"

Der Befehl gibt die instanzübergreifende Konfiguration der Gruppe zurück, falls vorhanden.

REST

Senden Sie eine GET-Anfrage an eine zonale oder regionale MIG und prüfen Sie das Feld allInstancesConfig.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

Wenn das Feld allInstancesConfig nicht festgelegt ist, hat die Gruppe keine instanzübergreifende Konfiguration.

Attribute aus einer instanzübergreifenden Konfiguration löschen

Wenn Sie ein Attribut aus der instanzübergreifenden Konfiguration der MIG löschen und dasselbe Attribut in der Instanzvorlage der MIG vorhanden ist, übernehmen VMs in der MIG das Attribut aus der Instanzvorlage noch einmal, nachdem die neueste Konfiguration auf VMs in der MIG angewendet wurde. Weitere Informationen zum Anwenden der neuesten Konfiguration auf vorhandene VMs finden Sie unter Instanzübergreifende Konfiguration auf vorhandene VMs anwenden.

Verwenden Sie eine der folgenden Methoden, um Attribute aus einer instanzübergreifenden Konfiguration zu löschen.

Console

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

    Zu den Instanzgruppen

  2. Wählen Sie die MIG aus, aus der Sie die instanzübergreifende Konfiguration löschen möchten.

  3. Klicken Sie auf VMs aktualisieren.

  4. Führen Sie im Abschnitt Konfiguration aller Instanzen folgende Schritte aus:

    • Zum Löschen von Metadaten klicken Sie auf Metadaten verwalten.
    • Zum Löschen von Labels klicken Sie auf Labels verwalten.

  5. Führen Sie im Bereich Metadaten verwalten oder Labels verwalten die folgenden Schritte aus:

    1. Halten Sie den Mauszeiger über eine Einstellung, um die Löschoption zu aktivieren, und klicken Sie dann auf Element löschen.
    2. Klicken Sie auf Speichern.

  6. Klicken Sie nach dem Löschen auf VMs aktualisieren.

    Wenn der Updatetyp der MIG auf Automatisch festgelegt ist, werden die Änderungen in der instanzübergreifenden Konfiguration sofort auf alle vorhandenen VMs angewendet. Wenn der Aktualisierungstyp Selektiv ist, müssen Sie die Konfiguration selektiv auf vorhandene VMs anwenden. Weitere Informationen finden Sie unter Instanzübergreifende Konfiguration auf vorhandene VMs anwenden.

gcloud

Verwenden Sie zum Löschen von Attributen den Betabefehl all-instances-configuration delete und geben Sie einen oder mehrere Schlüssel für die Attribute an, die Sie löschen möchten.

gcloud beta compute instance-groups managed all-instances-config delete INSTANCE_GROUP_NAME \
    --metadata=KEY1[, KEY1]\
    --labels=KEY1[, KEY1]

Denken Sie daran, die aktualisierte Konfiguration auf vorhandene VMs in der MIG anzuwenden.

REST

Um Attribute zu löschen, senden Sie eine PATCH-Anfrage an eine zonale oder regionale MIG und geben Sie einen null-Wert als Schlüssel für jedes Attribut an, das Sie entfernen möchten.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME
{
  "allInstancesConfig": {
    "properties": {
      "metadata": {
        "KEY1": null,
        ...
      },
      "labels": {
        "KEY2": null,
        ...
      }
    }
  }
}

Denken Sie daran, die aktualisierte Konfiguration auf vorhandene VMs in der MIG anzuwenden.

Nächste Schritte