Diese Seite wurde von der Cloud Translation API übersetzt.

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. Instanzvorlagen sind unveränderlich und können nach der 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 App, möchten aber unterschiedliche 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 auf Ihren VMs ausgeführt und möchten ihn mithilfe von Metadaten konfigurieren. Sie möchten dafür sorgen, dass die VM-Agent-Konfiguration auch nach einer Änderung der Instanzvorlage der Gruppe erhalten bleibt. 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 bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
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.

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

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

Zu den Instanzgruppen
Wählen Sie die verwaltete Instanzgruppe aus, für die Sie die Konfiguration für alle Instanzen festlegen möchten.
Klicken Sie auf VMs aktualisieren.
Führen Sie im Abschnitt Konfiguration für alle Instanzen die folgenden Schritte aus:
- Wenn Sie Metadatenwerte hinzufügen oder aktualisieren möchten, klicken Sie auf Metadaten verwalten. Schließen Sie die Einrichtung ab und klicken Sie auf Speichern.
- Klicken Sie auf Labels verwalten, um Labels hinzuzufügen oder zu aktualisieren. Schließen Sie die Einrichtung ab und klicken Sie auf Speichern.
Wenn Sie die Eigenschaften in der instanzübergreifenden Konfiguration eingerichtet haben, klicken Sie auf VMs aktualisieren.

Wenn der Aktualisierungstyp der MIG auf Automatisch festgelegt ist, wird die von Ihnen festgelegte instanzübergreifende 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

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

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

Ersetzen Sie Folgendes:

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 durch den Befehl „update“ 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/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

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

Ersetzen Sie Folgendes:

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 durch die Anfrage hinzugefügt. Die Werte vorhandener Schlüssel werden aktualisiert.

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

Instanzübergreifende Konfiguration auf vorhandene VMs anwenden

Die VM-Konfiguration, die Sie für VMs in einer MIG angeben, 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 erneut 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 Automatischer (proaktiver) Aktualisierungstyp.

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

Sie müssen sie nur einmal konfigurieren, um proaktive Updates zu verwenden. 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 update-Befehl konfigurieren.

gcloud 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

Ersetzen Sie Folgendes:

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 der verwalteten Instanzgruppe (z. B. 10%) sein.
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 der verwalteten Instanzgruppe (z. B. 10%) sein.
MIN_READY (optional): Mindestdauer, nach der eine neu gestartete oder ersetzte VM als verfügbar betrachtet werden soll. Zum Beispiel 10s für 10 Sekunden. Weitere Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes.
MINIMAL_ACTION (optional): Aktion, die bei der Konfigurationsaktualisierung auf jeder Instanz ausgeführt werden soll:
- refresh: Die neue Konfiguration wird auf laufende 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, auf die die neue Konfiguration angewendet werden soll.
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/v1/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
  }
}

Ersetzen Sie Folgendes:

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. Wenn Sie eine feste Anzahl angeben möchten, 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 bei der Konfigurationsaktualisierung auf jeder Instanz ausgeführt werden soll:
- REFRESH: Die neue Konfiguration wird auf laufende 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, auf die die neue Konfiguration angewendet werden soll.
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 festlegen möchten, wann und auf welche VMs eine neue Konfiguration angewendet werden soll, legen Sie den Aktualisierungsrichtlinientyp der Gruppe auf „opportunistisch“ fest. 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 update-Befehl konfigurieren:

gcloud 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

Verwenden Sie den folgenden Befehl, um ausgewählte Instanzen zu aktualisieren:

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

Ersetzen Sie Folgendes:

INSTANCE_GROUP_NAME: Name der MIG.
INSTANCE_NAMES: Eine Liste der Instanzen, auf die die Vorlage angewendet werden soll.
MINIMAL_ACTION (optional): Aktion, die bei der Konfigurationsaktualisierung auf jeder Instanz ausgeführt werden soll:
- refresh (Standard): Die neue Konfiguration wird auf laufende 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, auf die die neue Konfiguration angewendet werden soll.
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 refresh beispielsweise, 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. Es reicht beispielsweise aus, Instanzen anzuhalten und wieder zu starten, 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/v1/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/v1/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

Aktualisieren Sie alle vorhandenen Instanzen mit der folgenden Anfrage:

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

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

Ersetzen Sie Folgendes:

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 bei der Konfigurationsaktualisierung auf jeder Instanz ausgeführt werden soll:
- REFRESH: Die neue Konfiguration wird auf laufende 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, auf die die neue Konfiguration angewendet werden soll.
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 REFRESH beispielsweise, 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. Es reicht beispielsweise aus, Instanzen anzuhalten und wieder zu starten, um Änderungen am Maschinentyp anzuwenden.
- REPLACE: Alte Instanzen werden gemäß dem Feld updatePolicy.replacementMethod der Gruppe ersetzt.

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

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

Zu den Instanzgruppen
Wählen Sie die verwaltete Instanzgruppe aus, für die Sie die Konfiguration für alle Instanzen aufrufen möchten.
Wechseln Sie zum Tab Details.
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 an, wann Sie die instanzübergreifende Konfiguration auf alle VMs angewendet haben.
- Status: Hier wird Auf alle VMs angewendet angezeigt. Wenn die instanzübergreifende Konfiguration nicht auf alle VMs angewendet wird, wird der Status Ausstehende VM-Aktualisierung angezeigt.

gcloud

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

gcloud 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, wurde 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 describe-instance-Befehl prüfen:

gcloud 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/v1/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 festgelegt ist, wurde 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/v1/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. Sie haben folgende Möglichkeiten, die Konfiguration der gesamten Instanz zu prüfen:

Console

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

Zu den Instanzgruppen
Wählen Sie die verwaltete Instanzgruppe aus, für die Sie die Konfiguration für alle Instanzen aufrufen möchten.
Wechseln Sie zum Tab Details.
Weitere Informationen finden Sie im Abschnitt Konfiguration für alle 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 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/v1/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.

Sie haben folgende Möglichkeiten, Attribute aus einer instanzübergreifenden Konfiguration zu löschen:

Console

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

Zu den Instanzgruppen
Wählen Sie die verwaltete Instanzgruppe aus, aus der Sie die Konfiguration für alle Instanzen löschen möchten.
Klicken Sie auf VMs aktualisieren.
Führen Sie im Abschnitt Konfiguration für alle Instanzen die folgenden Schritte aus:
- Wenn Sie Metadaten löschen möchten, klicken Sie auf Metadaten verwalten.
- Wenn Sie Labels löschen möchten, klicken Sie auf Labels verwalten.
Führen Sie im Bereich Metadaten verwalten oder Labels verwalten die folgenden Schritte aus:
1. Bewegen Sie den Mauszeiger auf eine Einstellung, um die Löschoption zu aktivieren, und klicken Sie dann auf Element löschen.
2. Klicken Sie auf Speichern.
Klicken Sie nach dem Löschen auf VMs aktualisieren.

Wenn der Aktualisierungstyp der MIG Automatisch ist, werden die Änderungen an 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 Befehl all-instances-configuration delete und geben Sie einen oder mehrere Schlüssel für das Attribut an, das Sie löschen möchten.

gcloud 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/v1/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

Weitere Informationen zum automatischen Anwenden einer aktualisierten Konfiguration auf vorhandene VMs in einer MIG
Weitere Informationen zum selektiven Anwenden von Konfigurationsaktualisierungen auf vorhandene VMs in einer MIG
Informationen zu MIGs und zugehörigen VMs ansehen