Details und Status von Erweiterungen auf einer VM ansehen

Mit den schreibgeschützten Erweiterungsstatusmethoden list und get können Sie den Laufzeitstatus installierter Erweiterungen auf jeder VM-Instanz aufrufen, ohne eine Verbindung zu jeder Maschine herstellen zu müssen. Wenn Sie Erweiterungsrichtlinien verwenden, können auf einer VM mehrere Erweiterungen von verschiedenen Richtlinien installiert sein. Mit den Methoden für den Erweiterungsstatus können Sie die endgültige effektive Konfiguration und die geltende Richtlinie für jede installierte Erweiterung aufrufen. Außerdem können Sie damit Fehler beheben, wenn eine unerwartete Erweiterung installiert wird oder eine Erweiterung auf einer Instanz fehlschlägt.

Details und Statusinformationen zu Erweiterungen

Sie installieren VM-Erweiterungen auf VMs, indem Sie globale oder zonale Erweiterungsrichtlinien auf Organisations-, Ordner- oder Projektebene erstellen. Mit einer einzelnen Richtlinie können mehrere Erweiterungen auf einer einzelnen VM installiert werden. Außerdem können mehrere Richtlinien in Ihrer Ressourcenhierarchie auf dieselbe VM angewendet werden.

Mit den Methoden für den Erweiterungsstatus mit Lesezugriff können Sie die Status aller Erweiterungen auf der VM auflisten, um die endgültige effektive Konfiguration und den Laufzeitstatus jeder installierten Erweiterung aufzurufen. Die zurückgegebenen Informationen enthalten die aktive Version, den Erzwingungsstatus, den Zustand und die Kennung der geltenden Richtlinie für jede Erweiterung.

VM-Erweiterungen und -Versionen ansehen

Sie können die Google Cloud CLI oder die Compute Engine API verwenden, um Details zu installierten VM-Erweiterungen aufzurufen. In diesem Dokument wird die Verwendung von gcloud beschrieben. Informationen zum Verwenden der Compute Engine API zum Aufrufen von Erweiterungsstatus finden Sie unter MV-Erweiterungsstatus auf einer Instanz aufrufen.

Erforderliche IAM-Berechtigungen zum Aufrufen von Erweiterungsdetails

Wählen Sie eine der folgenden Ebenen aus, um die Rollen zu sehen, die erforderlich sind, um Informationen zu installierten Erweiterungen und deren Versionen auf Projekt-, Ordner- oder Organisationsebene aufzurufen:

Projekt

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-VM-Erweiterungsrichtlinien-Betrachter (roles/compute.vmExtensionPolicyViewer) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen zonaler oder globaler VM-Erweiterungsrichtlinien auf Projektebene benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen zonaler oder globaler VM-Erweiterungsrichtlinien auf Projektebene erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um zonale oder globale VM-Erweiterungsrichtlinien auf Projektebene anzusehen:

  • Beschreiben Sie eine bestimmte VM-Erweiterung auf einer Instanz: compute.vmExtensions.get
  • Alle VM-Erweiterungen auf einer Instanz auflisten: compute.vmExtensions.list

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Ordner

Erweiterungsrichtlinien auf Ordnerebene sind in der Vorschau verfügbar.

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) für Ihren Ordner zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen zonaler oder globaler VM-Erweiterungsrichtlinien auf Ordnerebene benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von zonalen oder globalen VM-Erweiterungsrichtlinien auf Ordnerebene erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um zonale oder globale VM-Erweiterungsrichtlinien auf Ordnerebene aufzurufen:

  • Beschreiben Sie eine bestimmte VM-Erweiterung auf einer Instanz: compute.folderVmExtensions.get
  • Alle VM-Erweiterungen auf einer Instanz auflisten: compute.folderVmExtensions.list

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Organisation

Erweiterungsrichtlinien auf Organisationsebene sind in der Vorabversion verfügbar.

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Organization level Compute VM extension policies viewer (roles/compute.orgVmExtensionPolicyViewer) für Ihre Organisation zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen zonaler oder globaler VM-Erweiterungsrichtlinien auf Organisationsebene benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von zonalen oder globalen VM-Erweiterungsrichtlinien auf Organisationsebene erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um zonale oder globale VM-Erweiterungsrichtlinien auf Organisationsebene anzusehen:

  • Beschreiben Sie eine bestimmte VM-Erweiterung auf einer Instanz: compute.orgVmExtensions.get
  • Alle VM-Erweiterungen auf einer Instanz auflisten: compute.orgVmExtensions.list

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Weitere Informationen zu IAM-Rollen und -Berechtigungen in Compute Engine finden Sie unter Compute Engine-Rollen und -Berechtigungen.

VM-Erweiterungen und -Versionen auflisten

Wählen Sie eine der folgenden Optionen aus, um die VM-Erweiterungen und -Versionen aufzulisten, die von VM Extension Manager zonenübergreifend oder global in Ihrem Projekt, Ordner oder Ihrer Organisation verwaltet werden:

Zonal

Verwenden Sie den Befehl gcloud preview compute zone-vm-extension-policies extensions list, um die VM-Erweiterungen in einer Zone innerhalb Ihres Projekts, Ordners oder Ihrer Organisation aufzulisten:

Projektebene

gcloud preview compute zone-vm-extension-policies extensions list \
  --project=PROJECT_ID \
  --zone=ZONE

Ersetzen Sie im Befehl die folgenden Variablen:

  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.
Ordner- und Organisationsebenen

Wenn Sie die vorherige Aufgabe auf Ordner- oder Organisationsebene ausführen möchten, verwenden Sie denselben Befehl mit einer der folgenden Änderungen:

  • Wenn Sie Informationen auf Ordnerebene abrufen möchten, ersetzen Sie die Option --project=PROJECT_ID durch --folder=folders/FOLDER_ID. Dabei ist FOLDER_ID die numerische ID Ihres Ordners.
  • Ersetzen Sie für Informationen auf Organisationsebene die Option --project=PROJECT_ID durch --organization=organizations/ORGANIZATION_ID, wobei ORGANIZATION_ID die numerische ID Ihrer Organisation ist.

Global

Verwenden Sie den Befehl gcloud preview compute global-vm-extension-policies extensions list, um die VM-Erweiterungen in allen Zonen Ihres Projekts, Ordners oder Ihrer Organisation aufzulisten:

Projektebene

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

Ersetzen Sie die folgende Variable im Befehl:

  • PROJECT_ID: Die Kennung des Projekts.
Ordner- und Organisationsebenen

Wenn Sie die vorherige Aufgabe auf Ordner- oder Organisationsebene ausführen möchten, verwenden Sie denselben Befehl mit einer der folgenden Änderungen:

  • Wenn Sie Informationen auf Ordnerebene abrufen möchten, ersetzen Sie die Option --project=PROJECT_ID durch --folder=folders/FOLDER_ID. Dabei ist FOLDER_ID die numerische ID Ihres Ordners.
  • Ersetzen Sie für Informationen auf Organisationsebene die Option --project=PROJECT_ID durch --organization=organizations/ORGANIZATION_ID, wobei ORGANIZATION_ID die numerische ID Ihrer Organisation ist.

Informationen zu einer bestimmten VM-Erweiterung ansehen

Wählen Sie eine der folgenden Optionen aus, um die Details einer bestimmten VM-Erweiterung in einer einzelnen Zone oder global in Ihrem Projekt, Ordner oder Ihrer Organisation aufzurufen:

Zonal

Verwenden Sie den Befehl gcloud preview compute zone-vm-extension-policies extensions describe, um die Details einer bestimmten VM-Erweiterung in einer Zone in Ihrem Projekt, Ordner oder Ihrer Organisation aufzurufen:

Projektebene

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ersetzen Sie im Befehl die folgenden Variablen:

  • EXTENSION_NAME: Eine der vom VM Extension Manager unterstützten Erweiterungen, z. B. ops-agent.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.
Ordner- und Organisationsebenen

Wenn Sie die vorherige Aufgabe auf Ordner- oder Organisationsebene ausführen möchten, verwenden Sie denselben Befehl mit einer der folgenden Änderungen:

  • Wenn Sie Informationen auf Ordnerebene abrufen möchten, ersetzen Sie die Option --project=PROJECT_ID durch --folder=folders/FOLDER_ID. Dabei ist FOLDER_ID die numerische ID Ihres Ordners.
  • Ersetzen Sie für Informationen auf Organisationsebene die Option --project=PROJECT_ID durch --organization=organizations/ORGANIZATION_ID, wobei ORGANIZATION_ID die numerische ID Ihrer Organisation ist.

Global

Verwenden Sie den Befehl gcloud preview compute global-vm-extension-policies extensions describe, um die Details einer bestimmten VM-Erweiterung in allen Zonen Ihres Projekts, Ordners oder Ihrer Organisation aufzurufen:

Projektebene

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

Ersetzen Sie im Befehl die folgenden Variablen:

Ordner- und Organisationsebenen

Wenn Sie die vorherige Aufgabe auf Ordner- oder Organisationsebene ausführen möchten, verwenden Sie denselben Befehl mit einer der folgenden Änderungen:

  • Wenn Sie Informationen auf Ordnerebene abrufen möchten, ersetzen Sie die Option --project=PROJECT_ID durch --folder=folders/FOLDER_ID. Dabei ist FOLDER_ID die numerische ID Ihres Ordners.
  • Ersetzen Sie für Informationen auf Organisationsebene die Option --project=PROJECT_ID durch --organization=organizations/ORGANIZATION_ID, wobei ORGANIZATION_ID die numerische ID Ihrer Organisation ist.

Status von VM-Erweiterungen auf einer Instanz ansehen

Durch Erweiterungsrichtlinien können mehrere Erweiterungen auf einer einzelnen VM installiert werden. Um den Status der einzelnen Erweiterungen zu ermitteln, einschließlich der effektiven Konfiguration, des Laufzeitstatus und anderer Informationen, können Sie den Status der Erweiterungen auf einer bestimmten VM prüfen.

Die Methoden für den Erweiterungsstatus geben nur Informationen zu Ops-Agent-Instanzen zurück, die von VM Extension Manager-Richtlinien installiert und verwaltet werden. Wenn auf einigen VMs Agents ausgeführt werden, die auf andere Weise installiert wurden, gibt es für diese Agents keine Erweiterungsinformationen, die gemeldet werden können.

Sie können die Google Cloud CLI oder die Compute Engine API verwenden, um den Status der auf VMs installierten Erweiterungen aufzurufen. In diesem Dokument wird die Verwendung von gcloud beschrieben. Informationen zum Verwenden der Compute Engine API zum Aufrufen von Erweiterungsstatus finden Sie unter MV-Erweiterungsstatus auf einer Instanz aufrufen.

Erforderliche IAM-Berechtigungen zum Aufrufen des Erweiterungsstatus

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-Betrachter (roles/compute.viewer) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen der VM-Erweiterungsstatus auf einer Instanz benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von VM-Erweiterungsstatus auf einer Instanz erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um den Status von VM-Erweiterungen auf einer Instanz aufzurufen:

  • Listen Sie die Status aller VM-Erweiterungen auf einer Instanz auf: compute.instances.listVmExtensionStates
  • Rufen Sie den Status einer bestimmten VM-Erweiterung auf einer Instanz ab: compute.instances.getVmExtensionState

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Auf einer VM-Instanz installierte Erweiterungen auflisten

Wenn Sie alle auf einer Instanz installierten VM-Erweiterungen auflisten und ihren aktuellen Status mit gcloud aufrufen möchten, führen Sie den Befehl gcloud beta compute instances list-vm-extension-states aus:

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Ersetzen Sie im Befehl die folgenden Variablen:

  • INSTANCE_NAME: Der Name der VM-Instanz.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zone, in der sich die Instanz befindet, z. B. us-central1-f.

Der Befehl gibt den Namen, den Erzwingungsstatus und den Zustand jeder installierten Erweiterung zurück. Informationen zu den Werten, die beim Aufrufen von Erweiterungsstatus zurückgegeben werden, finden Sie unter Statusfelder für VM-Erweiterungen interpretieren.

Weitere Informationen zum Aufrufen von Informationen zum Status von Erweiterungen auf Ihren VMs, einschließlich Informationen zur Verwendung der Compute Engine API, finden Sie unter VM-Erweiterungsstatus auf einer Instanz ansehen.

Status einer bestimmten VM-Erweiterung auf einer Instanz aufrufen

Führen Sie den Befehl gcloud beta compute instances get-vm-extension-state aus, um mit gcloud Statusinformationen zu einer bestimmten VM-Erweiterung abzurufen, die auf einer VM installiert ist:

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE \
    --extension-name=EXTENSION_NAME

Ersetzen Sie im Befehl die folgenden Variablen:

  • INSTANCE_NAME: Der Name der VM-Instanz.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zone, in der sich die Instanz befindet, z. B. us-central1-f.
  • EXTENSION_NAME: Eine der vom VM Extension Manager unterstützten Erweiterungen, z. B. ops-agent.

Der Befehl gibt den Namen der Erweiterung, die aktive Version, Informationen zum Status, Informationen zur Durchsetzung und die ID der geltenden Richtlinie zurück. Informationen zu den Werten, die beim Aufrufen von Erweiterungsstatus zurückgegeben werden, finden Sie unter Statusfelder für VM-Erweiterungen interpretieren.

Weitere Informationen zum Aufrufen von Informationen zum Status von Erweiterungen auf Ihren VMs, einschließlich Informationen zur Verwendung der Compute Engine API, finden Sie unter VM-Erweiterungsstatus auf einer Instanz ansehen.

Nächste Schritte