Ops-Agenten mit VM Extension Manager-Richtlinien verwalten

Sie können die Art und Weise, wie eine Richtlinie den Ops-Agenten verwaltet, ändern, indem Sie die Richtlinie aktualisieren. Wenn Sie eine Richtlinie aktualisieren, führt VM Extension Manager die Änderungen auf allen entsprechenden VMs aus, in der Regel innerhalb einer Minute. Je nachdem, wie eine Richtlinie geändert wird, wird der Ops-Agent möglicherweise auf neuen VMs installiert oder von vorhandenen VMs deinstalliert.

Hinweis

Bevor Sie VM Extension Manager-Erweiterungsrichtlinien verwenden, müssen Sie Folgendes tun:

  • Weisen Sie die Rollen zu, die zum Verwalten von VM Extension Manager-Richtlinien erforderlich sind.

  • Wenn Sie eine Befehlszeile zum Erstellen und Verwalten von Erweiterungsrichtlinien verwenden möchten und die Google Cloud CLI noch nicht installiert haben, installieren Sie die gcloud CLI.

    Sie können zonale VM-Erweiterungsrichtlinien mit derGoogle Cloud Console oder der Google Cloud CLI (gcloud) erstellen und verwalten. Globale VM-Erweiterungsrichtlinien werden mit gcloud erstellt und verwaltet.

Rollen zuweisen, die zum Verwalten von VM Extension Manager-Richtlinien erforderlich sind

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen, Ändern und Löschen von VM-Erweiterungsrichtlinien benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Aufrufen, Ändern und Löschen von VM-Erweiterungsrichtlinien erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um VM-Erweiterungsrichtlinien aufzurufen, zu ändern und zu löschen:

  • So rufen Sie Erweiterungsrichtlinien auf: compute.vmExtensionPolicies.list
  • So rufen Sie die Details einer Erweiterungsrichtlinie auf: compute.vmExtensionPolicies.get
  • So ändern Sie Erweiterungsrichtlinien: compute.vmExtensionPolicies.update
  • So löschen Sie Erweiterungsrichtlinien: compute.vmExtensionPolicies.delete

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.

Erweiterungsrichtlinien ändern, die den Ops-Agenten verwalten

Wenn Sie ändern möchten, wie eine Richtlinie den Ops-Agent verwaltet, aktualisieren Sie die Richtlinie. Wenn Sie eine Richtlinie aktualisieren, führt VM Extension Manager die Änderungen auf allen entsprechenden VMs aus, in der Regel innerhalb einer Minute. Wenn Sie Einschlusslabels ändern, wird der Ops-Agent möglicherweise auf neuen VMs installiert oder von vorhandenen VMs deinstalliert, je nachdem, ob die VMs mit den aktualisierten Labels übereinstimmen.

In den folgenden Abschnitten wird gezeigt, wie Sie eine Richtlinie ändern, um Folgendes zu tun:

Angepinnte Version des Ops-Agents auf allen VMs in einer Zone aktualisieren

So ändern Sie die angepinnte Version des Ops-Agents auf allen VMs in einer Zone:

Console

Zum Erstellen einer zonalen Richtlinie können Sie die Google Cloud Console verwenden.

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

    Zu den Erweiterungsrichtlinien

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

  2. Wählen Sie die Richtlinie aus, die Sie aktualisieren möchten.
  3. Klicken Sie auf Bearbeiten.
  4. Gehen Sie im Abschnitt Erweiterungen verwalten so vor:
    1. Wählen Sie in der Liste Erweiterung die Option Google Cloud's Extension for Ops Agent aus.
    2. Ändern Sie das Feld Version. Verwenden Sie Version 2.58.0 oder höher.
    3. Klicken Sie auf Fertig.
  5. Klicken Sie auf Speichern.

gcloud

Sie können die gcloud CLI verwenden, um eine zonale oder globale Richtlinie zu erstellen.

Zonal

Verwenden Sie den Befehl gcloud compute zone-vm-extension-policies update mit der Option --version, um die angepinnte Agent-Version zu ändern.

Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Richtlinie vollständig ersetzt. Alle optionalen Felder, die Sie in der Anfrage weglassen, werden daher auf ihre Standardwerte zurückgesetzt, anstatt die vorhandenen Werte aus der geänderten Richtlinie beizubehalten.

Verwenden Sie den folgenden Befehl, um die Version des Ops-Agents, der auf allen VMs in einer Zone installiert ist, durch eine Richtlinie zu ändern:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --version=ops-agent=VERSION

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.
  • VERSION: Die zu installierende Version des Ops-Agents. Verwenden Sie Version 2.58.0 oder höher. Eine Liste der Versionen finden Sie auf der Seite mit den Ops-Agent-Releases auf GitHub.

    Wenn Sie die Option --version weglassen, installiert die Richtlinie die aktuelle Version und aktualisiert den Ops-Agent, wenn eine neue Version veröffentlicht wird, wie im Beispiel gezeigt, in dem die aktuelle Version installiert wird.

Global

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies update mit der Option --version, um die angepinnte Agent-Version zu ändern.

Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Richtlinie vollständig ersetzt. Alle optionalen Felder, die Sie in der Anfrage weglassen, werden daher auf ihre Standardwerte zurückgesetzt, anstatt die vorhandenen Werte aus der geänderten Richtlinie beizubehalten.

Verwenden Sie den folgenden Befehl, um die Version des Ops-Agents zu ändern, der auf allen VMs durch eine globale Richtlinie installiert wurde:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • VERSION: Die zu installierende Version des Ops-Agents. Verwenden Sie Version 2.58.0 oder höher. Eine Liste der Versionen finden Sie auf der Seite mit den Ops-Agent-Releases auf GitHub.

    Wenn Sie die Option --version weglassen, installiert die Richtlinie die aktuelle Version und aktualisiert den Ops-Agent, wenn eine neue Version veröffentlicht wird, wie im Beispiel gezeigt, in dem die aktuelle Version installiert wird.

Konfiguration des Ops-Agenten auf allen VMs ändern

So ändern Sie die Konfiguration des Ops-Agents:

Console

Zum Erstellen einer zonalen Richtlinie können Sie die Google Cloud Console verwenden.

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

    Zu den Erweiterungsrichtlinien

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

  2. Wählen Sie die Richtlinie aus, die Sie aktualisieren möchten.
  3. Klicken Sie auf Bearbeiten.
  4. Gehen Sie im Abschnitt Erweiterungen verwalten so vor:
    1. Wählen Sie in der Liste Erweiterung die Option Google Cloud's Extension for Ops Agent aus.
    2. Geben Sie im Feld Inhalt der Konfigurationsdatei den YAML-Konfigurationsstring für den Ops-Agenten ein.
    3. Klicken Sie auf Fertig.
  5. Klicken Sie auf Speichern.

gcloud

Sie können die gcloud CLI verwenden, um eine zonale oder globale Richtlinie zu erstellen.

Zonal

Verwenden Sie den Befehl gcloud compute zone-vm-extension-policies update mit der Option --config-from-file oder --config, um eine neue Konfiguration anzugeben.

Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Richtlinie vollständig ersetzt. Alle optionalen Felder, die Sie in der Anfrage weglassen, werden daher auf ihre Standardwerte zurückgesetzt, anstatt die vorhandenen Werte aus der geänderten Richtlinie beizubehalten.

Verwenden Sie den folgenden Befehl, um die Konfiguration des Ops-Agents, der auf allen VMs in einer Zone installiert ist, durch eine Richtlinie zu ändern:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.
  • OPS_AGENT_CONFIG_PATH: Der Pfad zu einer Datei, die den YAML-Konfigurationsstring für den Ops-Agent enthält. Diese Datei muss in der Umgebung vorhanden sein, in der Sie den gcloud-Befehl ausführen.

    Die YAML-Konfiguration für den Ops-Agenten kann lang sein. Die Konfiguration in eine Datei zu schreiben und die Datei an die gcloud CLI zu übergeben, ist viel weniger fehleranfällig, als zu versuchen, korrekt formatiertes YAML in der Befehlszeile einzugeben.

Global

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies update mit der Option --config-from-file oder --config, um eine neue Konfiguration anzugeben.

Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Richtlinie vollständig ersetzt. Alle optionalen Felder, die Sie in der Anfrage weglassen, werden daher auf ihre Standardwerte zurückgesetzt, anstatt die vorhandenen Werte aus der geänderten Richtlinie beizubehalten.

Verwenden Sie den folgenden Befehl, um die Konfiguration des Ops-Agenten zu ändern, der auf allen VMs durch eine Richtlinie installiert wurde:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • OPS_AGENT_CONFIG_PATH: Der Pfad zu einer Datei, die den YAML-Konfigurationsstring für den Ops-Agent enthält. Diese Datei muss in der Umgebung vorhanden sein, in der Sie den gcloud-Befehl ausführen.

    Die YAML-Konfiguration für den Ops-Agenten kann lang sein. Die Konfiguration in eine Datei zu schreiben und die Datei an die gcloud CLI zu übergeben, ist viel weniger fehleranfällig, als zu versuchen, korrekt formatiertes YAML in der Befehlszeile einzugeben.

Wenn Sie beim Erstellen oder Aktualisieren einer Erweiterungsrichtlinie eine benutzerdefinierte Konfiguration für den Ops-Agenten angeben, wird der Ops-Agent mit der benutzerdefinierten Konfiguration bereitgestellt. Sie müssen den Agenten nicht manuell neu starten.

Die Konfiguration wird mit der Erweiterungsrichtlinie gespeichert. Nehmen Sie daher keine sensiblen Daten wie Passwörter in die Konfiguration auf. Da die Konfiguration mit der Erweiterungsrichtlinie gespeichert wird, ändert sich die Konfiguration des Agents nicht, wenn Sie die Konfigurationsdatei ändern. Sie müssen die mit der Richtlinie gespeicherte Konfiguration mit dem entsprechenden gcloud-Befehl aktualisieren:

Wenn Sie eine benutzerdefinierte Konfiguration für den Ops-Agenten bereitstellen, kopiert der VM Extension Manager die Konfiguration an den Speicherort, der vom Ops-Agenten für benutzerdefinierte Konfigurationsdateien auf der Ziel-VM verwendet wird:

  • Linux: /etc/google-cloud-ops-agent/config.yaml
  • Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

Wenn auf der VM eine config.yaml-Datei vorhanden ist, wird sie von der Erweiterungsrichtlinie überschrieben.

Allgemeine Informationen zur Verwendung derGoogle Cloud Console und der gcloud CLI zum Verwalten von VM-Erweiterungsrichtlinien finden Sie unter Erweiterungen durch Aktualisieren einer VM-Erweiterungsrichtlinie ändern.

Vorhandene globale Richtlinie um neue Zonen erweitern (nur global)

Wenn VMs in neuen Zonen erstellt werden, nachdem eine globale Richtlinie erstellt und eingeführt wurde, wendet VM Extension Manager die Richtlinie nicht automatisch auf die VMs in den neuen Zonen an. Wenn Sie die VMs in neue Zonen aufnehmen möchten, müssen Sie das Roll-out der globalen Richtlinie neu starten.

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies update und geben Sie die Option --rollout-retry-uuid=UUID an, um ein globales Richtlinien-Roll-out neu zu starten.

Angenommen, Sie haben mit dem folgenden Befehl eine globale Richtlinie erstellt und eingeführt:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml"

Wenn Sie die Richtlinie auf VMs in zuvor nicht verwendeten Zonen ausweiten möchten, starten Sie den Roll-out mit dem folgenden Befehl neu:

gcloud compute global-vm-extension-policies update test-policy POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --rollout-retry-uuid=UUID

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • UUID: Ein Universally Unique Identifier (UUID), der die Wiederholungsanfrage identifiziert. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Weitere Informationen finden Sie unter Roll-out wiederholen .

Globale Richtlinie aktualisieren, um eine Reihe von Zonen auszuschließen (nur global)

Wenn Sie die Zonen aktualisieren möchten, auf die eine globale Richtlinie angewendet wird, die einige Zonen in einemGoogle Cloud -Projekt ausschließt, müssen Sie einen neuen benutzerdefinierten Roll-out-Plan verwenden, in dem die Zonen angegeben sind, auf die die Richtlinie angewendet werden soll. Informationen zum Erstellen benutzerdefinierter Roll-out-Pläne finden Sie unter Roll-out-Pläne. Wenn Sie eine Reihe von Zonen angeben möchten, verwenden Sie beim Erstellen des Roll-out-Plans das Feld locationSelector.includedLocations.

Verwenden Sie den folgenden gcloud compute global-vm-extension-policies update-Befehl, um eine Erweiterungsrichtlinie zu aktualisieren, die einen benutzerdefinierten Roll-out-Plan verwendet:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
  --rollout-retry-uuid=UUID

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • NEW_CUSTOM_PLAN_NAME: Der Name, der mit Ihrem aktualisierten benutzerdefinierten Roll-out-Plan verknüpft ist.
  • UUID: Ein Universally Unique Identifier (UUID), der die Wiederholungsanfrage identifiziert. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Weitere Informationen finden Sie unter Roll-out wiederholen .

Ops-Agent durch Löschen von VM-Erweiterungsrichtlinien deinstallieren

Wenn Sie den Ops-Agent deinstallieren möchten, löschen Sie die VM-Erweiterungsrichtlinie, die den Agent verwaltet. Wenn eine andere aktive Richtlinie mit niedrigerer Priorität für eine VM gilt und auch den Ops-Agent verwaltet, bleibt der Agent auf dieser VM gemäß der Richtlinie mit niedrigerer Priorität installiert.

VM Extension Manager entfernt den Ops-Agent innerhalb einer Minute nach dem Löschen der Richtlinie von allen zugänglichen VMs. Wenn eine VM nicht zugänglich ist, überspringt VM Extension Manager das Löschen des Agents. Wenn die VM wieder verfügbar ist, entfernt der VM Extension Manager den Agenten zu diesem Zeitpunkt.

Console

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

    Zu den Erweiterungsrichtlinien

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

  2. Wählen Sie die Richtlinie aus, die Sie löschen möchten.
  3. Klicken Sie auf Löschen.
  4. Klicken Sie im Bestätigungsdialogfeld auf Löschen.

gcloud

Zonal

Verwenden Sie den Befehl gcloud compute zone-vm-extension-policies delete, um die VM-Erweiterungsrichtlinie zu löschen, die den Ops-Agent verwaltet:

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.

Global

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies delete, um die globale VM-Erweiterungsrichtlinie zu löschen, die den Ops-Agent verwaltet:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=slow_rollout

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.

Wenn Sie ein bereits gestartetes Lösch-Rollout beschleunigen möchten, geben Sie einen neuen Löschbefehl mit dem Plan fast_rollout aus. Sie müssen auch die Option --rollout-retry-uuid=UUID angeben:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=fast_rollout \
  --rollout-retry-uuid=UUID

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • UUID: Ein Universally Unique Identifier (UUID), der die Wiederholungsanfrage identifiziert. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Weitere Informationen finden Sie unter Roll-out wiederholen .

Informationen zu VM-Erweiterungsrichtlinien abrufen

Sie können die folgenden Informationen zu vorhandenen VM-Erweiterungsrichtlinien abrufen:

  • Eine Liste aller Richtlinien in Ihrem Google Cloud -Projekt.
  • Konfigurationsinformationen zu einer bestimmten Richtlinie.

Console

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

    Zu den Erweiterungsrichtlinien

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

    Auf dieser Seite werden alle VM-Erweiterungsrichtlinien in Ihrem Projekt aufgeführt.
  2. Klicken Sie auf den Namen der Richtlinie, um Details zu einer bestimmten Erweiterungsrichtlinie aufzurufen.

gcloud

Zonal

VM-Erweiterungsrichtlinien auflisten

Verwenden Sie den Befehl gcloud compute zone-vm-extension-policies list, um Informationen zu allen VM-Erweiterungsrichtlinien in einer Zone aufzulisten:

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE_INTEGER

Ersetzen Sie im Befehl die folgenden Variablen:

  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.
  • PAGE_SIZE_INTEGER: Die Anzahl der Richtlinien, die pro Seite aufgelistet werden sollen, z. B. 2. Weitere Informationen zu Sortier- und Filteroptionen finden Sie unter gcloud compute zone-vm-extension-policies list.

Benannte VM-Erweiterungsrichtlinie beschreiben

Verwenden Sie den Befehl gcloud compute zone-vm-extension-policies describe, um die Konfiguration einer benannten Richtlinie in einer Zone abzurufen:

gcloud compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.

Global

Globale VM-Erweiterungsrichtlinien auflisten

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies list, um Informationen zu globalen VM-Erweiterungsrichtlinien aufzulisten:

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE_INTEGER

Ersetzen Sie im Befehl die folgenden Variablen:

  • PROJECT_ID: Die Kennung des Projekts.
  • PAGE_SIZE_INTEGER: Die Anzahl der Richtlinien, die pro Seite aufgelistet werden sollen, z. B. 2. Weitere Informationen zu Sortier- und Filteroptionen finden Sie unter gcloud compute global-vm-extension-policies list.

Benannte globale VM-Erweiterungsrichtlinie beschreiben

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies describe, um die Konfiguration einer benannten Richtlinie in einer Zone abzurufen:

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.

Allgemeine Informationen zur Verwendung derGoogle Cloud Console und der gcloud CLI zum Abrufen von Informationen zu VM-Erweiterungsrichtlinien finden Sie unter Erweiterungsrichtlinien ansehen.

Über eine Erweiterungsrichtlinie installierten Ops-Agent neu starten

Wenn der Ops-Agent vom VM Extension Manager installiert und verwaltet wird, wird er nicht vom Systemverwaltungsdienst des Betriebssystems verwaltet, d. h. nicht von systemd unter Linux oder vom Windows Service Manager unter Windows. Daher funktionieren Linux-systemctl-Befehle und Windows-*-Service-Befehle nicht mit einem Ops-Agent, der über eine Erweiterungsrichtlinie installiert wurde.

So starten Sie einen Ops-Agent neu, der über eine Erweiterungsrichtlinie installiert wurde:

  • Erstellen Sie die Richtlinie neu.

    1. Löschen Sie die Richtlinie. Wenn Sie die Richtlinie löschen, wird der Ops-Agent beendet und deinstalliert.

    2. Erstellen Sie eine neue Richtlinie. Mit der neuen Richtlinie wird der Ops-Agent installiert und gestartet.

  • Verwenden Sie eine temporäre Richtlinie mit höherer Priorität. Wenn die ursprüngliche Richtlinie eine große Anzahl von VMs betrifft, Sie den Ops-Agent aber nur auf einer kleinen Anzahl neu starten möchten, fügen Sie diesen VMs ein Label hinzu und konfigurieren Sie die neue Richtlinie so, dass nach dem Label gefiltert wird.

    Wenn beispielsweise eine Richtlinie mit Priorität 1000 den Ops-Agenten auf einer VM nicht starten konnte, können Sie der VM ein Label wie status=failed hinzufügen. Erstellen Sie dann eine neue Richtlinie mit einer höheren Priorität, z. B. 500. Ein Google Cloud CLI-Befehl könnte beispielsweise so aussehen:

    Zonal 

    gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml

    Ersetzen Sie im Befehl die folgenden Variablen:

    • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
    • PROJECT_ID: Die Kennung des Projekts.
    • ZONE: Die Zielzone, z. B. us-central1-f.

    Global 

    gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml \
  --rollout-predefined-plan=fast_rollout

    Ersetzen Sie im Befehl die folgenden Variablen:

    • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
    • PROJECT_ID: Die Kennung des Projekts.

    Nachdem der Ops-Agent durch die neue Richtlinie erfolgreich installiert wurde, löschen Sie die Richtlinie und entfernen Sie das Label von den VMs. Der Ops-Agent bleibt auf der VM installiert, da die ursprüngliche Richtlinie noch aktiv ist.

Debugging-Log für Gast-Agent auf der VM aktivieren

VM Extension Manager-Richtlinien verwenden den Compute Engine-Gast-Agent, um den Ops-Agent als VM-Erweiterung zu verwalten. Informationen zum Aktivieren des Debugging-Logs für den Gast-Agent finden Sie unter Debugging-Logs für den Gast-Agent ansehen.

Nächste Schritte