Informationen zu MIGs und verwalteten Instanzen ansehen

Verwenden Sie die Methoden auf dieser Seite, um Informationen zu Ihren verwalteten Instanzgruppen (MIGs) sowie Informationen zu den VM-Instanzen in den einzelnen MIGs aufzurufen.

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.

  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.

Informationen zu MIGs aufrufen

Sie können Informationen zu Gruppen abrufen, um beispielsweise die mit der Gruppe verknüpften Richtlinien zu überprüfen und zu prüfen, ob die Gruppe stabil ist oder ob gerade Änderungen an ihr durchgeführt werden. Weitere Informationen zu den VM-Instanzen in einer MIG finden Sie unter Informationen zu den verwalteten VM-Instanzen in einer MIG anzeigen.

MIGs auflisten

Eine Liste der verwalteten Instanzgruppen können Sie entweder mit der Console, der gcloud CLI oder REST abrufen.

gcloud compute instance-groups managed list

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers

Attribute einer MIG aufrufen

Zum Aufrufen von Informationen zu einer bestimmten MIG, einschließlich der Richtlinien (z. B. Richtlinien für die automatische Reparatur und Aktualisierung der Gruppe), verwenden Sie die Konsole, die gcloud CLI oder REST.

Zum Ansehen des id-Werts der Gruppe müssen Sie die gcloud CLI oder die Compute Engine API verwenden.

gcloud compute instance-groups managed describe instance-group \
    [--zone zone | --region region]

gcloud compute instance-groups managed describe instance-group --format="(autoscaler)"

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/regionAutoscalers/mig_name

Stabilität einer MIG prüfen

Sie können mit verschiedenen Befehlen und Anfragen Instanzen in einer verwalteten Instanzgruppe erstellen, löschen und ändern. Diese Vorgänge werden mit dem Status DONE zurückgegeben, nachdem die Gruppe Aktionen zum Erstellen, Löschen oder Aktualisieren dieser Instanzen geplant hat. Die Instanzen in der Gruppe sind jedoch erst dann erstellt, gelöscht oder aktualisiert, wenn diese zugrunde liegenden Aktionen abgeschlossen sind. Sie müssen den Status der Gruppe überprüfen oder alternativ den Status der entsprechenden Instanzen überprüfen.

Eine verwaltete Instanzgruppe ist stabil, wenn an keinen Instanzen in der verwalteten Instanzgruppe Änderungen vorgenommen werden, keine zukünftigen Änderungen für die Instanzen geplant sind und die Gruppe selbst nicht gerade geändert wird.

Sie möchten z. B. wissen, ob eine Gruppe stabil ist, wenn Sie Abhängigkeiten haben, die voraussetzen, dass alle Instanzen in der Gruppe fehlerfrei ausgeführt werden. Sie können beispielsweise beginnen, Jobs zu planen, Traffic zu senden oder Schlüsselbereiche zuzuweisen, nachdem Sie sich vergewissert haben, dass alle VMs ausgeführt werden und fehlerfrei sind.

Prüfen Sie, ob alle Instanzen in einer verwalteten Instanzgruppe ausgeführt werden und fehlerfrei sind, indem Sie den Wert des Feldes status.isStable der Gruppe prüfen.

gcloud compute instance-groups managed describe instance-group-name \
    [--zone zone | --region region]

gcloud compute instance-groups managed wait-until instance-group-name \
    --stable \
    [--zone zone | --region region]
Waiting for group to become stable, current operations: deleting: 4
Waiting for group to become stable, current operations: deleting: 4
...
Group is stable

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/get

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group-name/get

Wenn status.isStable auf false gesetzt ist, bedeutet das, dass Änderungen aktiv sind, ausstehen oder dass die MIG selbst geändert wird.

Wenn status.isStable auf true gesetzt ist, bedeutet das Folgendes:

• Die Instanzen in der MIG werden nicht geändert und die currentAction für alle Instanzen ist NONE.
• Es gibt keine Änderungen bei Instanzen in der MIG.
• Die MIG selbst wird nicht geändert.

Beachten Sie, dass die Stabilität einer MIG von zahlreichen Faktoren abhängt, da eine MIG auf verschiedene Arten geändert werden kann. Beispiel:

• Sie stellen eine Anfrage, um eine neue Instanzvorlage bereitzustellen.
• Sie stellen eine Anfrage, um in der Gruppe Instanzen zu erstellen, zu löschen, deren Größe anzupassen oder sie zu aktualisieren.
• Durch das Autoscaling wird eine Anfrage gestellt, um die Größe der MIG zu ändern.
• Eine Ressource für die automatische Reparatur ersetzt in der MIG eine oder mehrere fehlerhafte Instanzen.
• In einer regionalen MIG werden einige der Instanzen neu verteilt.

Sobald alle Aktionen abgeschlossen sind, wird status.isStable wieder auftrue gesetzt für diese MIG.

Informationen zu einzelnen VM-Instanzen finden Sie unter Status von verwalteten Instanzen überprüfen.

MIG auf Deaktivierung von VM-Reparaturen prüfen

Um zu prüfen, ob die VM-Reparaturen in einer MIG deaktiviert sind, verwenden Sie die Console, die gcloud CLI oder die API.

gcloud compute instance-groups managed describe instance-group \
    --format="(instanceLifecyclePolicy)"

instanceLifecyclePolicy:
  defaultActionOnFailure: REPAIR
  forceUpdateOnRepair: NO

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP

"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "NO",
  "defaultActionOnFailure": "REPAIR"
}

Wenn Sie nicht möchten, dass eine MIG eine fehlgeschlagene oder fehlerhafte VM in der Gruppe repariert, können Sie die Reparaturen in der MIG deaktivieren.

Frühere automatische Reparaturvorgänge ansehen

Wenn Sie die automatische Reparatur konfiguriert haben, können Sie vergangene automatische Reparaturereignisse anzeigen.

Rolling Updates beobachten

Wenn Sie ein Rolling Update initiiert haben und wissen möchten, wann das Update abgeschlossen ist, informieren Sie sich unter Updates überwachen.

Zustandsorientierte Konfiguration aufrufen

Wenn Sie eine zustandsorientierte MIG konfiguriert haben und die Konfiguration prüfen möchten, finden Sie unter Zustandsorientierte Konfiguration aufrufen weitere Informationen.

Informationen zu den verwalteten VM-Instanzen in einer MIG aufrufen

Verwaltete Instanzen einer MIG auflisten

Eine Liste der verwalteten Instanzen in einer Gruppe einschließlich ihrer Status und Vorlagen können Sie entweder mit der Console, der gcloud CLI oder REST abrufen.

gcloud compute instance-groups managed list-instances instance-group \
    [--zone zone | --region region]

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

Status von verwalteten Instanzen prüfen

Sie können mit verschiedenen Befehlen und Anfragen Instanzen in einer verwalteten Instanzgruppe erstellen, löschen und ändern. Diese Vorgänge werden mit dem Status DONE zurückgegeben, nachdem die Gruppe Aktionen zum Erstellen, Löschen oder Aktualisieren dieser Instanzen geplant hat. Die Instanzen in der Gruppe sind jedoch erst dann erstellt, gelöscht oder aktualisiert, wenn diese zugrunde liegenden Aktionen abgeschlossen sind. Prüfen Sie den Status der betreffenden Instanzen oder alternativ den Status der Gruppe selbst.

Verwenden Sie die Google Cloud CLI oder REST, um Details zu den Instanzen in einer verwalteten Instanzgruppe aufzurufen. Die Details enthalten den Instanzstatus und die aktuellen Aktionen, die die Gruppe auf ihren Instanzen ausführt.

gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
    [--zone=ZONE | --region=REGION]

NAME               ZONE           STATUS   HEALTH_STATE  ACTION  INSTANCE_TEMPLATE  VERSION_NAME  LAST_ERROR
vm-instances-9pk4  us-central1-f                          CREATING  my-new-template
vm-instances-h2r1  us-central1-f  STOPPING                DELETING  my-old-template
vm-instances-j1h8  us-central1-f  RUNNING                 NONE      my-old-template
vm-instances-ngod  us-central1-f  RUNNING                 NONE      my-old-template

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

currentAction: NONE
id: '6789072894767812345'
instance: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-mig-hz41
instanceStatus: RUNNING
name: example-mig-hz41
preservedStateFromConfig:
  metadata:
    example-key: example-value
preservedStateFromPolicy:
  disks:
    persistent-disk-0:
      autoDelete: NEVER
      mode: READ_WRITE
      source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-mig-hz41
version:
  instanceTemplate: https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

{
 "managedInstances": [
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-prvp",
   "id": "5317605642920955957",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-pz5j",
   "currentAction": "DELETING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-w2t5",
   "id": "2800161036826218547",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  }
 ]
}

Eine Liste der gültigen instanceStatus-Feldwerte finden Sie unter Lebenszyklus von VM-Instanzen.

Wenn an einer Instanz eine Änderung vorgenommen wird, setzt das verwaltete Feld der Instanz das Feld currentAction auf eine der folgenden Aktionen, damit Sie den Fortschritt der Änderung verfolgen können. Andernfalls wird das Feld currentAction auf NONE gesetzt.

Folgende currentAction-Werte sind möglich:

• ABANDONING. Die Instanz wird gerade aus der MIG entfernt.
• CREATING: Die Instanz wird gerade erstellt.
• CREATING_WITHOUT_RETRIES. Die Instanz wird ohne Neuversuche erstellt. Wenn die Instanz beim ersten Versuch nicht erstellt wird, versucht die MIG nicht, die Instanz noch einmal zu ersetzen.
• DELETING: Die Instanz wird gerade gelöscht.
• RECREATING. Die Instanz wird gerade ersetzt.
• REFRESHING: Die Instanz wird aus den aktuellen Zielpools entfernt und anschließend zu den in der Liste enthaltenen Zielpools wieder hinzugefügt. Diese Liste kann mit den bestehenden Zielpools identisch sein oder davon abweichen.
• RESTARTING: Die Instanz wird gerade mit den Methoden stop und start neu gestartet.
• RESUMING. Die Instanz wird gerade fortgesetzt, nach dem sie vorher gesperrt war.
• STARTING. Die Instanz wird gerade gestartet, nachdem sie vorher beendet wurde.
• STOPPING: Die Instanz wird beendet.
• SUSPENDING: Die Instanz wird angehalten.
• VERIFYING: Die Instanz wurde erstellt und wird gerade verifiziert.
• NONE: Für die Instanz werden gerade keine Aktionen durchgeführt.

Informationen zum Überprüfen, ob die Gruppe insgesamt stabil ist oder gerade geändert wird, finden Sie unter Status der Gruppe überprüfen.

Systemzustände prüfen

Wenn Sie die automatische Reparatur für Ihre verwaltete Instanzgruppe konfiguriert haben, können Sie jede einzelne VM auf ihren Systemstatus prüfen. Weitere Informationen finden Sie im Abschnitt zur Prüfung des Systemstatus.

Instanzfehler auflisten

Wenn bei Ihren verwalteten Instanzen Fehler aufgetreten sind, können Sie diese aufrufen, um ihre Ursache zu ermitteln und das Problem zu beheben.

Verwenden Sie die Google Cloud Console, die gcloud CLI oder REST, um eine Liste der Fehler aufzurufen.

gcloud compute instance-groups managed list-errors instance-group-name \
    [--zone zone | --region region]

gcloud compute instance-groups managed list-errors example-group \
    --region us-west1

INSTANCE_URL                                                                                        ACTION    ERROR_CODE      ERROR_MESSAGE                                                                                     TIMESTAMP                      INSTANCE_TEMPLATE                                                                                                            VERSION_NAME

https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-v0hl  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-v0hl' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.156-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-qp3d  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-qp3d' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.081-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
...

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/listErrors&maxResults=100

{
 "items": [
  {
   "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Instance 'example-mig-m1sz' creation failed: Quota 'CPUS' exceeded.  Limit: 50.0 in zone us-central1-c."
   },
   "timestamp": "2019-01-03T18:47:28.457-08:00",
   "instanceDetails" : {
    "instance": "zones/us-central1-c/instances/example-mig-m1sz",
    "action": "CREATING",
    "version": {
     "name": "example-version-name",
     "instanceTemplate": "global/instanceTemplates/example-template",
    }
   }
  }
 ],
 ...
 "nextPageToken": "Ch0yMDE5LTA3LTI5VDExOjA4OjA2LjYxMi0wNzowMBJ5aHR0cHM6Ly93d3cuZ29vZ2xlYXBpcy5jb20vY29tcHV0ZS9zdGFnaW5nX2FscGhhL3Byb2plY3RzL215cnpha2VyZXltcy1zdGFnaW5nL3pvbmVzL3VzLWNlbnRyYWwxLWlyMS9pbnN0YW5jZXMvaWdtLTEtcXAzZA=="
}

Die Liste der möglichen Fehler umfasst unter anderem die folgenden Beispiele:

• Eine neue Instanz kann aus folgenden Gründen nicht erstellt werden:
  • Kapazität auf Abruf nicht verfügbar.
  • Unzureichendes Kontingent, z. B. für CPUs in einer bestimmten Region.
  • Das Limit für die Anzahl der VM-Instanzen wurde für das mit der Gruppe verknüpfte Netzwerk erreicht.
  • Das im Feld properties.disks[].initializeParams.sourceImage der Instanzvorlage angegebene Speicherabbild wurde gelöscht oder seine Berechtigungen wurden geändert.
  • Mit der im Rechnungskonto hinterlegten Kreditkarte, das mit dem Projekt verknüpft ist, konnte eine Zahlung nicht durchgeführt werden.
• Eine vorhandene Instanz kann aus folgendem Grund nicht gelöscht werden:
  • Dem Dienstkonto, das von dieser Gruppe verwendet wird, fehlt die Berechtigung compute.instances.delete.
  • Es wurden zu viele gleichzeitige Löschvorgänge angefordert, wodurch die geltenden Ratenbegrenzungen überschritten wurden.
• Eine Instanz kann einem Zielpool nicht hinzugefügt werden, da der Zielpool gelöscht wurde.

Nachdem Sie Fehler dieser Art geprüft haben, können Sie diese beheben. Beispiel:

• Verschieben Sie Ihre Arbeitslast in eine Zone mit Kapazität auf Abruf.
• Fordern Sie eine Kontingenterhöhung für eine bestimmte Region an.
• Fügen Sie dem Dienstkonto, das von der Gruppe verwendet wird, die Berechtigung compute.instances.delete hinzu.

Wenn eine von einer verwalteten Instanzgruppe ausgelöste Aktion fehlschlägt (z. B. wenn beim Autoscaling ein Fehler beim Versuch auftritt, die Gruppe zu vergrößern), wird die Aktion möglicherweise sofort wiederholt. Wenn der letzte sofortige Wiederholungsversuch fehlschlägt, wird der Fehler von der MIG aufgezeichnet und Sie können die Instanzfehler auflisten, um ihn anzusehen. Nach einer gewissen Backoff-Zeit wiederholt die Gruppe die fehlgeschlagene Aktion noch einmal. Wenn der Fehler dauerhaft besteht, wird er möglicherweise mehrmals aufgezeichnet.

Compute Engine behält die letzten 500 Fehler der letzten acht Tage bei, auch wenn die zugrunde liegenden Instanzen nicht mehr vorhanden sind oder nicht erstellt werden konnten.

Zugehörigkeit einer VM-Instanz zu einer MIG prüfen

Mit der Console oder REST können Sie prüfen, ob eine bestimmte VM Mitglied einer Gruppe ist.

Alternativ können Sie in den Metadaten der Instanz nach den beiden folgenden Metadatenschlüsseln suchen, um zu ermitteln, ob eine VM Mitglied einer verwalteten Instanzgruppe ist oder war:

• instance-template gibt die Vorlage an, aus der die VM erstellt wurde.
• created-by gibt die verwaltete Instanzgruppe an, die die VM erstellt hat.

Selbst wenn Sie die VM verwerfen, bleiben die Metadateneinträge erhalten, außer Sie entfernen diese manuell.

Wenn beispielsweise eine VM mit dem Namen random-instance-biy vorhanden ist und Sie wissen möchten, ob die VM von einer verwalteten Instanzgruppe erstellt wurde, können Sie die Instanz angeben und nach den Metadatenschlüsseln suchen. Beispiel:

gcloud compute instances describe random-instance-biy \
    --zone us-central1-f

Die gcloud CLI gibt in etwa folgende Antwort zurück:

canIpForward: false
cpuPlatform: Intel Ivy Bridge
creationTimestamp: '2016-08-24T14:11:38.012-07:00'
...
metadata:
  items:
  - key: instance-template
    value: projects/123456789012/global/instanceTemplates/example-it
  - key: created-by
    value: projects/123456789012/zones/us-central1-f/instanceGroupManagers/igm-metadata

Beibehaltenen Status einer verwalteten Instanz aufrufen

Wenn Sie eine zustandsorientierte MIG konfiguriert haben und den beibehaltenen Status jeder verwalteten Instanz aufrufen möchten, finden Sie unter Zustandsorientierte Konfiguration und beibehaltenen Status aufrufen weitere Informationen.

Nächste Schritte

• Verwaltete Instanzgruppen
• Erstellen Sie eine Instanzvorlage, mit der Sie eine verwaltete Instanzgruppe erstellen können.