VM-Erweiterungen durch Erstellen von Erweiterungsrichtlinien installieren

In diesem Dokument wird beschrieben, wie Sie VM-Erweiterungsrichtlinien erstellen, mit denen Sie Erweiterungen automatisch auf einer Flotte von Compute Engine-VMs installieren und verwalten können. Durch die Definition einer Richtlinie können Sie dafür sorgen, dass bestimmte Erweiterungen auf allen VMs installiert und verwaltet werden, die den von Ihnen angegebenen Kriterien entsprechen, z. B. VM-Labels. Sie können zonale oder globale VM-Erweiterungsrichtlinien auf Projektebene oder auf Organisations- und Ordnerebene erstellen (in der Vorabversion verfügbar).

Hinweis

Einschränkungen beim Erstellen von Richtlinien

Sie können VM-Erweiterungsrichtlinien auf Ordner- und Organisationsebene nur mit der Google Cloud CLI oder der Compute Engine REST API erstellen.

Richtlinienpriorität und Konfliktlösung

Wenn mehrere Richtlinien auf verschiedenen Hierarchieebenen (Organisation, Ordner oder Projekt) für dieselbe VM gelten, bestimmt die Hierarchieebene nicht die Priorität. Stattdessen verwendet VM Extension Manager die Richtlinienpriorität und Aktualisierungszeitstempel, um Konflikte zu lösen.

Wenn zwei Richtlinien für dieselbe Erweiterung im Konflikt stehen, hat die Richtlinie mit der höheren Priorität Vorrang. Die Prioritätswerte reichen von 0 bis 65535, wobei eine niedrigere Zahl eine höhere Priorität bedeutet. Die Standardpriorität ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an. Wenn Sie eine Richtlinie löschen, wird die Erweiterung nicht entfernt, wenn eine Richtlinie mit niedrigerer Priorität weiterhin für die VM gilt.

VM-Erweiterungen durch Erstellen einer globalen VM-Erweiterungsrichtlinie installieren

Sie können eine globale VM-Erweiterungsrichtlinie erstellen, um Erweiterungen auf VMs in mehreren Zonen gemäß einem Roll-out-Plan zu installieren. Sie können eine globale Richtlinie auf Projekt-, Ordner- oder Organisationsebene definieren (in der Vorschau verfügbar).

Der VM Extension Manager wendet eine globale VM-Erweiterungsrichtlinie nicht direkt auf VMs an. Stattdessen repliziert der VM Extension Manager die globale Definition beim Roll-out der Richtlinie automatisch in entsprechende zonale Richtlinien in jeder Zone, basierend auf dem Roll-out-Plan. Sobald eine replizierte Richtlinie in einer Zone verfügbar ist, prüft VM Extension Manager die VMs in dieser Zone anhand der Einschlusslabels der Richtlinie und installiert oder aktualisiert die entsprechenden Erweiterungen. Wenn Sie neue VMs erstellen, werden diese automatisch von VM Extension Manager bewertet und konfiguriert.

Roll-out-Pläne für globale Richtlinien

Globale VM-Erweiterungsrichtlinien verwenden Roll-out-Pläne, um die Bereitstellung von Erweiterungen an verschiedenen Standorten zu verwalten. Sie können einen der vordefinierten Roll-out-Pläne verwenden oder einen benutzerdefinierten Roll-out-Plan erstellen.

Vordefinierte Roll-out-Pläne

Sie können einen der folgenden vordefinierten Roll-out-Pläne auswählen:

  • slow_rollout: Die Richtlinie wird über fünf Tage hinweg eingeführt. Die langsame Einführung ist der Standard-Roll-out-Plan.
  • fast_rollout: Die Richtlinie wird sofort in allen Zonen eingeführt.

Benutzerdefinierte Roll-out-Pläne

Mit der Methode rolloutPlans.insert können Sie benutzerdefinierte Roll-out-Pläne erstellen. Im folgenden JSON-Beispiel wird ein Roll-out-Plan mit dem Namen test-rollout-plan definiert, der auf zwei Zonen abzielt:

{
  "name": "test-rollout-plan",
  "waves": [
    {
      "selectors": [
        {
          "locationSelector": {
            "includedLocations": [
              "us-central1-a",
              "us-west1-a"
            ]
          }
        }
      ],
      "validation": {
        "type": "time",
        "timeBasedValidationMetadata": {
          "waitDuration": "0s"
        }
      },
      "orchestrationOptions": {
        "maxConcurrentResourcesPerLocation": "10",
        "maxConcurrentLocations": "10"
      }
    }
  ]
}

Diesen benutzerdefinierten Roll-out-Plan können Sie dann beim Erstellen einer globalen Richtlinie verwenden.

VM-Erweiterungen in allen Zonen einer Organisation installieren

Erstellen Sie eine globale Erweiterungsrichtlinie auf Organisationsebene, um VM-Erweiterungen in allen Zonen in allen untergeordneten Projekten Ihrer Organisation zu installieren und zu verwalten.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) für Ihre Organisation zu gewähren, um die Berechtigung zu erhalten, die Sie zum Erstellen einer Erweiterungsrichtlinie 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 Berechtigung compute.orgVmExtensionPolicies.create, die zum Erstellen einer organisationsbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine globale Erweiterungsrichtlinie auf Organisationsebene zu erstellen:

gcloud

Verwenden Sie den Befehl gcloud preview compute global-vm-extension-policies create mit dem Flag --organization, um eine globale VM-Erweiterungsrichtlinie auf Organisationsebene zu erstellen:

gcloud preview compute global-vm-extension-policies create POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR

Ersetzen Sie Folgendes:

  • POLICY_NAME: ein Name für die VM-Erweiterungsrichtlinie.
  • ORGANIZATION_ID: die Organisations-ID für die Richtlinie auf Organisationsebene. Das Ressourcenformat ist organizations/{organization}/global/vmExtensionPolicies/{name}.
  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.
  • EXTENSION_NAME_1,EXTENSION_NAME_2: Eine durch Kommas getrennte Liste von Erweiterungen, die der Richtlinie hinzugefügt werden sollen. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert die Version der Erweiterung ist. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  • EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert der Pfad zur Konfigurationsdatei für diese Erweiterung ist. Diese Datei befindet sich auf der VM, auf der Sie den Befehl gcloud ausführen, nicht auf der VM, auf der Sie die Erweiterung installieren.

    Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen das Flag --config anstelle von --config-from-file, z. B. EXTENSION_NAME_1="CONFIG_1". Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.

  • KEY_1=VALUE_1: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches ODER). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in allen untergeordneten Projekten und Zonen der Organisation.
  • PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.
  • ROLLOUT_PLAN: Geben Sie slow_rollout oder fast_rollout an. Wenn Sie einen benutzerdefinierten Roll-out-Plan verwenden möchten, geben Sie das Flag --rollout-custom-plan anstelle von --rollout-predefined-plan im folgenden Format an:
    --rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

    Ersetzen Sie Folgendes:

    • ORGANIZATION_ID: die Organisation, in der der Roll-out-Plan definiert ist.
    • ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans.

    Wenn Sie kein Flag für den Roll-out-Plan angeben, verwendet der VM Extension Manager slow_rollout.

  • ROLLOUT_CONFLICT_BEHAVIOR: Gibt das Verhalten an, wenn VM Extension Manager einen Konflikt zwischen einer zonalen und einer globalen Richtlinie erkennt. Sie können eines der folgenden Konfliktverhalten angeben:
    • "" (leerer String): Die globale Richtlinie überschreibt keine in Konflikt stehenden zonalen Richtlinien mit demselben Namen. Dieses Konfliktverhalten ist die Standardeinstellung.
    • overwrite: Die globale Richtlinie überschreibt alle zonalen Richtlinien mit demselben Namen. Anschließend werden die Richtlinien-Roll-outs in der Zone über die globale Richtlinie verwaltet.

    Weitere Informationen finden Sie unter dem Flag --rollout-conflict-behavior.

Beispiel: Globale Richtlinie mit Organisationsbereich erstellen

Mit dem folgenden Befehl wird eine globale Richtlinie mit hoher Priorität namens prod-frontend-policy auf Organisationsebene (organizations/123456789) für Produktions-Frontend-Arbeitslasten (env=prod,workload=frontend) erstellt. Dabei wird eine bestimmte Version für die Erweiterung ops-agent mit einem langsamen Roll-out-Plan angepinnt:

gcloud preview compute global-vm-extension-policies create prod-frontend-policy \
  --organization=organizations/123456789 \
  --description="Standard monitoring policy for production frontend VMs" \
  --extensions=ops-agent \
  --version=ops-agent=2.58.0 \
  --config=ops-agent="some-monitoring-config" \
  --inclusion-labels="env=prod,workload=frontend" \
  --priority=100 \
  --rollout-predefined-plan=slow_rollout

REST

Senden Sie eine POST-Anfrage an die Methode organizationGlobalVmExtensionPolicies.insert, um eine globale VM-Erweiterungsrichtlinie auf Organisationsebene zu erstellen:

POST https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies

{
"name": "POLICY_NAME",
"description": "DESCRIPTION",
"extensionPolicies": {
   "EXTENSION_NAME_1": {
     "stringConfig": "EXTENSION_NAME_1_CONFIG",
     "pinnedVersion": "EXTENSION_NAME_1_VERSION"
  },
   "EXTENSION_NAME_2": {
     "stringConfig": "EXTENSION_NAME_2_CONFIG",
     "pinnedVersion": "EXTENSION_NAME_2_VERSION"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
       "inclusionLabels": {
         "KEY_1": "VALUE_1"
       }
    }
  }
],
"priority": "PRIORITY",
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

Ersetzen Sie Folgendes:

  • ORGANIZATION_ID: Ihre Organisations-ID.
  • POLICY_NAME: ein Name für die VM-Erweiterungsrichtlinie.
  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.
  • EXTENSION_NAME_1, EXTENSION_NAME_2: Der Name der Erweiterung, die der Richtlinie hinzugefügt werden soll. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1_CONFIG, EXTENSION_NAME_2_CONFIG: Die Konfiguration für die Erweiterung, die als Inline-String bereitgestellt wird.
  • EXTENSION_NAME_1_VERSION, EXTENSION_NAME_2_VERSION: Die Version der Erweiterung. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  • KEY_1: VALUE_1: Ein Schlüssel/Wert-Paar, das Einschlusslabels für einen Selektor definiert. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie mehrere instanceSelectors angeben, gilt die Richtlinie für VMs, die mit einem der angegebenen Selektoren übereinstimmen (logisches ODER). Wenn Sie instanceSelectors weglassen, gilt die Richtlinie für alle VMs in allen untergeordneten Projekten und Zonen der Organisation.
  • PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.
  • ROLLOUT_CONFLICT_BEHAVIOR: Gibt das Verhalten an, wenn VM Extension Manager einen Konflikt zwischen einer zonalen und einer globalen Richtlinie erkennt. Sie können eines der folgenden Konfliktverhalten angeben:
    • "" (leerer String): Die globale Richtlinie überschreibt keine in Konflikt stehenden zonalen Richtlinien mit demselben Namen. Dieses Konfliktverhalten ist die Standardeinstellung.
    • overwrite: Die globale Richtlinie überschreibt alle zonalen Richtlinien mit demselben Namen. Anschließend werden die Richtlinien-Roll-outs in der Zone über die globale Richtlinie verwaltet.

    Weitere Informationen finden Sie unter dem Flag --rollout-conflict-behavior.

  • ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans. Wenn Sie einen vordefinierten Roll-out-Plan verwenden möchten, ersetzen Sie das Feld name durch predefinedRolloutPlan und geben Sie einen der folgenden Werte an:
    • SLOW_ROLLOUT: Die Richtlinie wird über fünf Tage hinweg eingeführt. Dieser vordefinierte Plan ist der Standard-Roll-out-Plan, wenn Sie keinen Plan angeben.
    • FAST_ROLLOUT: Die Richtlinie wird sofort in allen Zonen eingeführt.

Beispiel: Globale Richtlinie mit Organisationsbereich erstellen

Im folgenden Beispiel wird eine globale Richtlinie mit dem Namen org-global-extension-policy erstellt, die die Erweiterung ops-agent für die Organisation 123456789 auf VMs mit dem Label env=prod, der Priorität 100 und einem vordefinierten Roll-out-Plan SLOW_ROLLOUT installiert:

POST https://compute.googleapis.com/compute/2026-10-01-preview/organizations/123456789/global/vmExtensionPolicies

{
"name": "org-global-extension-policy",
"description": "Standard monitoring policy for organization VMs",
"extensionPolicies": {
   "ops-agent": {
     "stringConfig": "logging:
      receivers:
        systemd_logs:
          type: systemd_journald
      service:
        pipelines:
          systemd_pipeline:
            receivers: [systemd_logs]",
     "pinnedVersion": "2.58.0"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
       "inclusionLabels": {
         "env": "prod"
       }
    }
  }
],
"priority": "100",
"rolloutOperation": {
  "rolloutInput": {
    "predefinedRolloutPlan": "SLOW_ROLLOUT"
  }
}
}

VM-Erweiterungen in allen Zonen in einem Ordner installieren

Erstellen Sie eine globale Erweiterungsrichtlinie auf Ordnerebene, um VM-Erweiterungen in allen Zonen in allen untergeordneten Projekten Ihres Ordners zu installieren und zu verwalten.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) für Ihren Ordner zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Erstellen einer ordnerbezogenen Erweiterungsrichtlinie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.folderVmExtensionPolicies.create, die zum Erstellen einer ordnerbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine globale Erweiterungsrichtlinie auf Ordnerebene zu erstellen:

gcloud

Verwenden Sie zum Erstellen einer globalen VM-Erweiterungsrichtlinie auf Ordnerebene den Befehl gcloud preview compute global-vm-extension-policies create mit dem Flag --folder:

gcloud preview compute global-vm-extension-policies create POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR

Ersetzen Sie Folgendes:

  • POLICY_NAME: ein Name für die VM-Erweiterungsrichtlinie.
  • FOLDER_ID: die Ordner-ID für die Richtlinie auf Ordnerebene. Das Ressourcenformat ist folders/{folder}/global/vmExtensionPolicies/{name}.
  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.
  • EXTENSION_NAME_1,EXTENSION_NAME_2: Eine durch Kommas getrennte Liste von Erweiterungen, die der Richtlinie hinzugefügt werden sollen. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert die Version der Erweiterung ist. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  • EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert der Pfad zur Konfigurationsdatei für diese Erweiterung ist. Diese Datei befindet sich auf der VM, auf der Sie den Befehl gcloud ausführen, nicht auf der VM, auf der Sie die Erweiterung installieren.

    Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen das Flag --config anstelle von --config-from-file, z. B. EXTENSION_NAME_1="CONFIG_1". Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.

  • KEY_1=VALUE_1: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches ODER). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in allen untergeordneten Projekten und Zonen innerhalb des Ordners.
  • PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.
  • ROLLOUT_PLAN: Geben Sie slow_rollout oder fast_rollout an. Wenn Sie einen benutzerdefinierten Roll-out-Plan verwenden möchten, geben Sie das Flag --rollout-custom-plan anstelle von --rollout-predefined-plan im folgenden Format an:
    --rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

    Ersetzen Sie Folgendes:

    • FOLDER_ID: der Ordner, in dem der Roll-out-Plan definiert ist.
    • ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans.

    Wenn Sie kein Flag für den Roll-out-Plan angeben, verwendet der VM Extension Manager slow_rollout.

  • ROLLOUT_CONFLICT_BEHAVIOR: Gibt das Verhalten an, wenn VM Extension Manager einen Konflikt zwischen einer zonalen und einer globalen Richtlinie erkennt. Sie können eines der folgenden Konfliktverhalten angeben:
    • "" (leerer String): Die globale Richtlinie überschreibt keine in Konflikt stehenden zonalen Richtlinien mit demselben Namen. Dieses Konfliktverhalten ist die Standardeinstellung.
    • overwrite: Die globale Richtlinie überschreibt alle zonalen Richtlinien mit demselben Namen. Anschließend werden die Richtlinien-Roll-outs in der Zone über die globale Richtlinie verwaltet.

    Weitere Informationen finden Sie unter dem Flag --rollout-conflict-behavior.

Beispiel: Globale Richtlinie auf Ordnerebene erstellen

Mit dem folgenden Befehl wird eine globale Richtlinie mit dem Namen folder-global-extension-policy auf Ordnerebene (folders/123456) erstellt, die die Erweiterung ops-agent auf VMs mit dem Label env=prod mithilfe eines langsamen Roll-out-Plans installiert:

gcloud preview compute global-vm-extension-policies create folder-global-extension-policy \
  --folder=folders/123456 \
  --description="Standard monitoring policy for folder VMs" \
  --extensions=ops-agent \
  --version=ops-agent=2.58.0 \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --inclusion-labels="env=prod" \
  --priority=100 \
  --rollout-predefined-plan=slow_rollout

REST

Senden Sie eine POST-Anfrage an die Methode folderGlobalVmExtensionPolicies.insert, um eine globale VM-Erweiterungsrichtlinie auf Ordnerebene zu erstellen:

POST https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies

{
"name": "POLICY_NAME",
"description": "DESCRIPTION",
"extensionPolicies": {
   "EXTENSION_NAME_1": {
     "stringConfig": "EXTENSION_NAME_1_CONFIG",
     "pinnedVersion": "EXTENSION_NAME_1_VERSION"
  },
   "EXTENSION_NAME_2": {
     "stringConfig": "EXTENSION_NAME_2_CONFIG",
     "pinnedVersion": "EXTENSION_NAME_2_VERSION"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
       "inclusionLabels": {
         "KEY_1": "VALUE_1"
       }
    }
  }
],
"priority": "PRIORITY",
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

Ersetzen Sie Folgendes:

  • FOLDER_ID: Ihre Ordner-ID.
  • POLICY_NAME: ein Name für die VM-Erweiterungsrichtlinie.
  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.
  • EXTENSION_NAME_1, EXTENSION_NAME_2: Der Name der Erweiterung, die der Richtlinie hinzugefügt werden soll. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1_CONFIG, EXTENSION_NAME_2_CONFIG: Die Konfiguration für die Erweiterung, die als Inline-String bereitgestellt wird.
  • EXTENSION_NAME_1_VERSION, EXTENSION_NAME_2_VERSION: Die Version der Erweiterung. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  • KEY_1: VALUE_1: Ein Schlüssel/Wert-Paar, das Einschlusslabels für einen Selektor definiert. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie mehrere instanceSelectors angeben, gilt die Richtlinie für VMs, die mit einem der angegebenen Selektoren übereinstimmen (logisches ODER). Wenn Sie instanceSelectors weglassen, gilt die Richtlinie für alle VMs in allen untergeordneten Projekten und Zonen innerhalb des Ordners.
  • PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.
  • ROLLOUT_CONFLICT_BEHAVIOR: Gibt das Verhalten an, wenn VM Extension Manager einen Konflikt zwischen einer zonalen und einer globalen Richtlinie erkennt. Sie können eines der folgenden Konfliktverhalten angeben:
    • "" (leerer String): Die globale Richtlinie überschreibt keine in Konflikt stehenden zonalen Richtlinien mit demselben Namen. Dieses Konfliktverhalten ist die Standardeinstellung.
    • overwrite: Die globale Richtlinie überschreibt alle zonalen Richtlinien mit demselben Namen. Anschließend werden die Richtlinien-Roll-outs in der Zone über die globale Richtlinie verwaltet.

    Weitere Informationen finden Sie unter dem Flag --rollout-conflict-behavior.

  • ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans. Wenn Sie einen vordefinierten Roll-out-Plan verwenden möchten, ersetzen Sie das Feld name durch predefinedRolloutPlan und geben Sie einen der folgenden Werte an:
    • SLOW_ROLLOUT: Die Richtlinie wird über fünf Tage hinweg eingeführt. Dieser vordefinierte Plan ist der Standard-Roll-out-Plan, wenn Sie keinen Plan angeben.
    • FAST_ROLLOUT: Die Richtlinie wird sofort in allen Zonen eingeführt.

Beispiel: Globale Richtlinie auf Ordnerebene erstellen

Im folgenden Beispiel wird eine globale Richtlinie mit dem Namen folder-global-extension-policy erstellt, die die Erweiterung ops-agent für den Ordner 123456 auf VMs mit dem Label env=prod, der Priorität 500 und einem vordefinierten Roll-out-Plan SLOW_ROLLOUT installiert:

POST https://compute.googleapis.com/compute/2026-10-01-preview/folders/123456/global/vmExtensionPolicies

{
"name": "folder-global-extension-policy",
"description": "Test extension policy for Ops Agent at folder level",
"extensionPolicies": {
   "ops-agent": {
     "stringConfig": "logging:
      receivers:
        systemd_logs:
          type: systemd_journald
      service:
        pipelines:
          systemd_pipeline:
            receivers: [systemd_logs]",
     "pinnedVersion": "2.58.0"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
       "inclusionLabels": {
         "env": "prod"
       }
    }
  }
],
"priority": "500",
"rolloutOperation": {
  "rolloutInput": {
    "predefinedRolloutPlan": "SLOW_ROLLOUT"
  }
}
}

VM-Erweiterungen in allen Zonen eines Projekts installieren

Erstellen Sie eine globale Erweiterungsrichtlinie auf Projektebene, um VM-Erweiterungen in allen Zonen Ihres Projekts zu installieren und zu verwalten.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Administrator für Compute-VM-Erweiterungsrichtlinien (roles/compute.vmExtensionPolicyAdmin) für Ihr Projekt zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Erstellen einer projektbezogenen Erweiterungsrichtlinie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.vmExtensionPolicies.create, die zum Erstellen einer projektbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine globale Erweiterungsrichtlinie auf Projektebene zu erstellen:

Console

So erstellen Sie eine projektbezogene globale VM-Erweiterungsrichtlinie in der Google Cloud Console:

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

    Zu „VM-Erweiterungsrichtlinien“

  2. Klicken Sie auf Erweiterungsrichtlinie erstellen.
  3. Geben Sie im Feld Name einen Namen für die Richtlinie ein.
  4. Optional: Geben Sie im Feld Beschreibung eine Beschreibung für die Richtlinie ein.
  5. Geben Sie im Feld Priorität eine Prioritätsnummer an, um Konflikte zwischen Richtlinien zu lösen. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000.
  6. Wählen Sie im Abschnitt Umfang die Option Globaler Roll-out aus.
  7. Klicken Sie im Bereich Erweiterungen verwalten auf Erweiterung hinzufügen und gehen Sie für jede Erweiterung, die Sie auf den Ziel-VMs installieren möchten, so vor:
    1. Wählen Sie in der Liste Erweiterung eine Erweiterung aus. Weitere Informationen finden Sie unter Unterstützte Erweiterungen.
    2. Wählen Sie in der Liste Version die Versionsnummer der Erweiterung aus. Lassen Sie das Feld leer, um die aktuelle Version auszuwählen.
      • Für den Ops-Agent können Sie die Version 2.58.0 oder höher angeben.
      • Lassen Sie das Feld für die Erweiterung für SAP und die Erweiterung für Compute-Arbeitslasten leer, um die aktuelle Version auszuwählen.
    3. Optional: Geben Sie im Feld Inhalt der Konfigurationsdatei Konfigurationsparameter für die Erweiterung ein.
  8. Wählen Sie im Feld Roll-out-Plan einen Roll-out-Plan aus den folgenden Optionen aus:
    • Langsamer Roll-out: Erweiterungen werden über einen bestimmten Zeitraum hinweg nach und nach auf Ihren VMs installiert. Dieser Roll-out-Plan ist die Standardoption.
    • Schneller Roll-out: Erweiterungen werden sofort auf allen Ziel-VMs in allen Zonen und Regionen installiert.

    Weitere Informationen zu Roll-out-Plänen finden Sie unter Roll-out-Pläne.

  9. Wählen Sie im Abschnitt Ziel-VM-Instanzen die VMs für die Richtlinie aus. Wenn Sie VMs mit bestimmten Labels auswählen möchten, klicken Sie auf Labels hinzufügen und fügen Sie das Schlüssel/Wert-Paar hinzu.
  10. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies create, um eine globale VM-Erweiterungsrichtlinie auf Projektebene zu erstellen:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR

Ersetzen Sie Folgendes:

  • POLICY_NAME: ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: die Projekt-ID für die projektbezogene Richtlinie.
  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.
  • EXTENSION_NAME_1,EXTENSION_NAME_2: Eine durch Kommas getrennte Liste von Erweiterungen, die der Richtlinie hinzugefügt werden sollen. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert die Version der Erweiterung ist. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  • EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert der Pfad zur Konfigurationsdatei für diese Erweiterung ist. Diese Datei befindet sich auf der VM, auf der Sie den Befehl gcloud ausführen, nicht auf der VM, auf der Sie die Erweiterung installieren.

    Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen das Flag --config anstelle von --config-from-file, z. B. EXTENSION_NAME_1="CONFIG_1". Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.

  • KEY_1=VALUE_1: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches ODER). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in Ihrem Projekt in allen Zonen.
  • PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.
  • ROLLOUT_PLAN: Geben Sie slow_rollout oder fast_rollout an. Wenn Sie einen benutzerdefinierten Roll-out-Plan verwenden möchten, geben Sie das Flag --rollout-custom-plan anstelle von --rollout-predefined-plan im folgenden Format an:
    --rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

    Ersetzen Sie Folgendes:

    • PROJECT_NUMBER: das Projekt, in dem der Roll-out-Plan definiert ist.
    • ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans.

    Wenn Sie kein Flag für den Roll-out-Plan angeben, verwendet der VM Extension Manager slow_rollout.

  • ROLLOUT_CONFLICT_BEHAVIOR: Gibt das Verhalten an, wenn VM Extension Manager einen Konflikt zwischen einer zonalen und einer globalen Richtlinie erkennt. Sie können eines der folgenden Konfliktverhalten angeben:
    • "" (leerer String): Die globale Richtlinie überschreibt keine in Konflikt stehenden zonalen Richtlinien mit demselben Namen. Dieses Konfliktverhalten ist die Standardeinstellung.
    • overwrite: Die globale Richtlinie überschreibt alle zonalen Richtlinien mit demselben Namen. Anschließend werden die Richtlinien-Roll-outs in der Zone über die globale Richtlinie verwaltet.

    Weitere Informationen finden Sie unter dem Flag --rollout-conflict-behavior.

Beispiel: Globale Richtlinie auf Projektebene erstellen

Mit dem folgenden Befehl wird eine Richtlinie mit dem Namen global-test-extension-policy erstellt, die die Erweiterung ops-agent für das Projekt test-project installiert. Das Flag --config-from-file gibt den Pfad zu einer lokalen Datei an, die eine YAML-Konfiguration für den Ops-Agent enthält, und --rollout-predefined-plan gibt den slow_rollout-Plan an.

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

Beispiel: Globale Richtlinie auf Projektebene mit einem benutzerdefinierten Roll-out-Plan erstellen

Mit dem folgenden Befehl wird eine Richtlinie namens global-test-extension-policy-2 erstellt, die die Erweiterung ops-agent für das Projekt test-project auf VMs mit dem Label env=prod installiert. Die Richtlinienpriorität ist auf 500 festgelegt und das Flag --config-from-file gibt den Pfad zu einer lokalen Datei an, die eine YAML-Konfiguration für den Ops-Agent enthält. Das Flag --rollout-custom-plan gibt einen benutzerdefinierten Roll-out-Plan an.

gcloud compute global-vm-extension-policies create global-test-extension-policy-2 \
  --project=test-project \
  --extensions=ops-agent \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --priority=500 \
  --inclusion-labels=env=prod \
  --rollout-custom-plan=projects/12345678/locations/global/rolloutPlans/test-rollout-plan

REST

Senden Sie eine POST-Anfrage an die Methode globalVmExtensionPolicies.insert, um eine globale VM-Erweiterungsrichtlinie auf Projektebene zu erstellen.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies

{
"name": "POLICY_NAME",
"description": "DESCRIPTION",
"extensionPolicies": {
   "EXTENSION_NAME_1": {
     "stringConfig": "EXTENSION_NAME_1_CONFIG",
     "pinnedVersion": "EXTENSION_NAME_1_VERSION"
  },
   "EXTENSION_NAME_2": {
     "stringConfig": "EXTENSION_NAME_2_CONFIG",
     "pinnedVersion": "EXTENSION_NAME_2_VERSION"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
       "inclusionLabels": {
         "KEY_1": "VALUE_1"
       }
    }
  }
],
"priority": "PRIORITY",
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Projekt-ID.
  • POLICY_NAME: ein Name für die VM-Erweiterungsrichtlinie.
  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.
  • EXTENSION_NAME_1, EXTENSION_NAME_2: Der Name der Erweiterung, die der Richtlinie hinzugefügt werden soll. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1_CONFIG, EXTENSION_NAME_2_CONFIG: Die Konfiguration für die Erweiterung, die als Inline-String bereitgestellt wird.
  • EXTENSION_NAME_1_VERSION, EXTENSION_NAME_2_VERSION: Die Version der Erweiterung. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  • KEY_1: VALUE_1: Ein Schlüssel/Wert-Paar, das Einschlusslabels für einen Selektor definiert. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie mehrere instanceSelectors angeben, gilt die Richtlinie für VMs, die mit einem der angegebenen Selektoren übereinstimmen (logisches ODER). Wenn Sie instanceSelectors weglassen, gilt die Richtlinie für alle VMs in Ihrem Projekt in allen Zonen.
  • PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.
  • ROLLOUT_CONFLICT_BEHAVIOR: Gibt das Verhalten an, wenn VM Extension Manager einen Konflikt zwischen einer zonalen und einer globalen Richtlinie erkennt. Sie können eines der folgenden Konfliktverhalten angeben:
    • "" (leerer String): Die globale Richtlinie überschreibt keine in Konflikt stehenden zonalen Richtlinien mit demselben Namen. Dieses Konfliktverhalten ist die Standardeinstellung.
    • overwrite: Die globale Richtlinie überschreibt alle zonalen Richtlinien mit demselben Namen. Anschließend werden die Richtlinien-Roll-outs in der Zone über die globale Richtlinie verwaltet.

    Weitere Informationen finden Sie unter dem Flag --rollout-conflict-behavior.

  • PROJECT_NUMBER: das Projekt, in dem der benutzerdefinierte Roll-out-Plan definiert ist.
  • ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans. Wenn Sie einen vordefinierten Roll-out-Plan verwenden möchten, ersetzen Sie das Feld name durch predefinedRolloutPlan und geben Sie einen der folgenden Werte an:
    • SLOW_ROLLOUT: Die Richtlinie wird über fünf Tage hinweg eingeführt. Dieser vordefinierte Plan ist der Standard-Roll-out-Plan, wenn Sie keinen Plan angeben.
    • FAST_ROLLOUT: Die Richtlinie wird sofort in allen Zonen eingeführt.

Beispiel: Globale Richtlinie auf Projektebene erstellen

Im folgenden Beispiel wird eine Richtlinie mit dem Namen global-test-extension-policy erstellt, die die Erweiterung ops-agent für das Projekt 12345678 auf VMs mit dem Label env=prod installiert. Die Richtlinienpriorität ist auf 500 festgelegt und es wird der Roll-out-Plan test-rollout-plan verwendet.

POST https://compute.googleapis.com/compute/v1/projects/12345678/global/vmExtensionPolicies

{
"name": "global-test-extension-policy",
"description": "Test extension policy for Ops Agent",
"extensionPolicies": {
   "ops-agent": {
     "stringConfig": "logging:
      receivers:
        systemd_logs:
          type: systemd_journald
      service:
        pipelines:
          systemd_pipeline:
            receivers: [systemd_logs]",
     "pinnedVersion": "2.58.0"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
       "inclusionLabels": {
         "env": "prod"
       }
    }
  }
],
"priority": "500",
"rolloutOperation": {
  "rolloutInput": {
    "name": "projects/12345678/locations/global/rolloutPlans/test-rollout-plan"
  }
}
}

VM-Erweiterungen durch Erstellen einer zonalen VM-Erweiterungsrichtlinie installieren

Sie können eine zonale VM-Erweiterungsrichtlinie erstellen, um festzulegen, welche Erweiterungen auf welchen VMs in einer bestimmten Zone installiert werden sollen. Sie können eine zonale Richtlinie auf Projekt-, Ordner- oder Organisationsebene definieren (in der Vorabversion verfügbar).

VM-Erweiterungen in einer Zone in einer Organisation installieren

Erstellen Sie eine zonale Erweiterungsrichtlinie auf Organisationsebene, um VM-Erweiterungen in einer bestimmten Zone in allen untergeordneten Projekten Ihrer Organisation zu installieren und zu verwalten.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) für Ihre Organisation zu gewähren, um die Berechtigung zu erhalten, die Sie zum Erstellen einer Erweiterungsrichtlinie 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 Berechtigung compute.orgVmExtensionPolicies.create, die zum Erstellen einer organisationsbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine zonale Erweiterungsrichtlinie auf Organisationsebene zu erstellen:

gcloud

Wenn Sie eine zonale VM-Erweiterungsrichtlinie auf Organisationsebene erstellen und die Richtlinie auf VMs in einer bestimmten Zone ausrollen möchten, verwenden Sie den Befehl gcloud preview compute zone-vm-extension-policies create mit dem Flag --organization:

gcloud preview compute zone-vm-extension-policies create POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

Ersetzen Sie Folgendes:

  • POLICY_NAME: ein Name für die VM-Erweiterungsrichtlinie.
  • ORGANIZATION_ID: die Organisations-ID für die Richtlinie auf Organisationsebene. Das Ressourcenformat ist organizations/{organization}/zones/{zone}/vmExtensionPolicies/{name}.
  • ZONE: die Zone, in der diese Richtlinie gilt.
  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.
  • EXTENSION_NAME_1,EXTENSION_NAME_2: Eine durch Kommas getrennte Liste von Erweiterungen, die der Richtlinie hinzugefügt werden sollen. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert die Version der Erweiterung ist. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  • EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert der Pfad zur Konfigurationsdatei für diese Erweiterung ist. Diese Datei befindet sich auf der VM, auf der Sie den Befehl gcloud ausführen, nicht auf der VM, auf der Sie die Erweiterung installieren.

    Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen das Flag --config anstelle von --config-from-file, z. B. EXTENSION_NAME_1="CONFIG_1". Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.

  • KEY_1=VALUE_1: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches ODER). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone in allen untergeordneten Projekten der Organisation.
  • PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.

Der Befehl schlägt fehl, wenn in der Zone bereits eine Richtlinie mit dem angegebenen Namen vorhanden ist.

Beispiel: Zonale Richtlinie mit Organisationsbereich erstellen

Mit dem folgenden Befehl wird eine zonale Richtlinie mit dem Namen org-test-extension-policy erstellt, die die Erweiterung ops-agent in der Zone us-central1-f für die Organisation organizations/123456789 auf VMs mit dem Label env=prod installiert:

gcloud preview compute zone-vm-extension-policies create org-test-extension-policy \
  --organization=organizations/123456789 \
  --zone=us-central1-f \
  --extensions=ops-agent \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --priority=100 \
  --inclusion-labels=env=prod

REST

Senden Sie eine POST-Anfrage an die Methode organizationZoneVmExtensionPolicies.insert, um eine zonale VM-Erweiterungsrichtlinie auf Organisationsebene zu erstellen. Mit dieser Methode wird festgelegt, welche Erweiterungen auf welchen VMs in einer bestimmten Zone in der gesamten Organisation installiert werden sollen.

POST https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies

{
"name": "POLICY_NAME",
"description": "DESCRIPTION",
"extensionPolicies": {
   "EXTENSION_NAME_1": {
     "stringConfig": "EXTENSION_NAME_1_CONFIG",
     "pinnedVersion": "EXTENSION_NAME_1_VERSION"
  },
   "EXTENSION_NAME_2": {
     "stringConfig": "EXTENSION_NAME_2_CONFIG",
     "pinnedVersion": "EXTENSION_NAME_2_VERSION"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
       "inclusionLabels": {
         "KEY_1": "VALUE_1"
       }
    }
  }
],
"priority": "PRIORITY"
}

Ersetzen Sie Folgendes:

  • ORGANIZATION_ID: Ihre Organisations-ID.
  • ZONE: die Zone, in der diese Richtlinie gilt.
  • POLICY_NAME: ein Name für die VM-Erweiterungsrichtlinie.
  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.
  • EXTENSION_NAME_1, EXTENSION_NAME_2: Der Name der Erweiterung, die der Richtlinie hinzugefügt werden soll. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1_CONFIG, EXTENSION_NAME_2_CONFIG: Die Konfiguration für die Erweiterung, die als Inline-String bereitgestellt wird.
  • EXTENSION_NAME_1_VERSION, EXTENSION_NAME_2_VERSION: Die Version der Erweiterung. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  • KEY_1: VALUE_1: Ein Schlüssel/Wert-Paar, das Einschlusslabels für einen Selektor definiert. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie mehrere instanceSelectors angeben, gilt die Richtlinie für VMs, die mit einem der angegebenen Selektoren übereinstimmen (logisches ODER). Wenn Sie instanceSelectors weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone in allen untergeordneten Projekten der Organisation.
  • PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.

Beispiel: Zonale Richtlinie mit Organisationsbereich erstellen

Im folgenden Beispiel wird eine Richtlinie mit dem Namen org-test-extension-policy erstellt, die die Erweiterung ops-agent in der Zone us-central1-f für die Organisation 123456789 installiert.

POST https://compute.googleapis.com/compute/2026-10-01-preview/organizations/123456789/zones/us-central1-f/vmExtensionPolicies

{
"name": "org-test-extension-policy",
"description": "Test extension policy for Ops Agent at organization level",
"extensionPolicies": {
   "ops-agent": {
     "stringConfig": "logging:
      receivers:
        systemd_logs:
          type: systemd_journald
      service:
        pipelines:
          systemd_pipeline:
            receivers: [systemd_logs]",
     "pinnedVersion": "2.58.0"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
       "inclusionLabels": {
         "env": "prod"
       }
    }
  }
],
"priority": "100"
}

VM-Erweiterungen in einer Zone in einem Ordner installieren

Erstellen Sie eine zonale Erweiterungsrichtlinie auf Ordnerebene, um VM-Erweiterungen in einer bestimmten Zone in allen Nachfolgerprojekten Ihres Ordners zu installieren und zu verwalten.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) für Ihren Ordner zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Erstellen einer ordnerbezogenen Erweiterungsrichtlinie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.folderVmExtensionPolicies.create, die zum Erstellen einer ordnerbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine zonale Erweiterungsrichtlinie mit Ordnerbereich zu erstellen:

gcloud

Wenn Sie eine zonale VM-Erweiterungsrichtlinie auf Ordnerebene erstellen und die Richtlinie auf VMs in einer bestimmten Zone ausrollen möchten, verwenden Sie den Befehl gcloud preview compute zone-vm-extension-policies create mit dem Flag --folder:

gcloud preview compute zone-vm-extension-policies create POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

Ersetzen Sie Folgendes:

  • POLICY_NAME: ein Name für die VM-Erweiterungsrichtlinie.
  • FOLDER_ID: die Ordner-ID für die Richtlinie auf Ordnerebene. Das Ressourcenformat ist folders/{folder}/zones/{zone}/vmExtensionPolicies/{name}.
  • ZONE: die Zone, in der diese Richtlinie gilt.
  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.
  • EXTENSION_NAME_1,EXTENSION_NAME_2: Eine durch Kommas getrennte Liste von Erweiterungen, die der Richtlinie hinzugefügt werden sollen. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert die Version der Erweiterung ist. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  • EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert der Pfad zur Konfigurationsdatei für diese Erweiterung ist. Diese Datei befindet sich auf der VM, auf der Sie den Befehl gcloud ausführen, nicht auf der VM, auf der Sie die Erweiterung installieren.

    Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen das Flag --config anstelle von --config-from-file, z. B. EXTENSION_NAME_1="CONFIG_1". Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.

  • KEY_1=VALUE_1: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches ODER). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone in allen untergeordneten Projekten im Ordner.
  • PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.

Der Befehl schlägt fehl, wenn in der Zone bereits eine Richtlinie mit dem angegebenen Namen vorhanden ist.

Beispiel: Zonale Richtlinie mit Ordnerbereich erstellen

Mit dem folgenden Befehl wird eine zonale Richtlinie mit dem Namen folder-test-extension-policy erstellt, die die Erweiterung ops-agent in der Zone us-central1-f für den Ordner folders/123456 auf VMs mit dem Label env=prod installiert:

gcloud preview compute zone-vm-extension-policies create folder-test-extension-policy \
  --folder=folders/123456 \
  --zone=us-central1-f \
  --extensions=ops-agent \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --priority=500 \
  --inclusion-labels=env=prod

REST

Senden Sie eine POST-Anfrage an die Methode folderZoneVmExtensionPolicies.insert, um eine zonale VM-Erweiterungsrichtlinie mit Ordnerbereich zu erstellen. Bei dieser Methode wird definiert, welche Erweiterungen auf welchen VMs in einer bestimmten Zone im Ordner installiert werden sollen.

POST https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies

{
"name": "POLICY_NAME",
"description": "DESCRIPTION",
"extensionPolicies": {
   "EXTENSION_NAME_1": {
     "stringConfig": "EXTENSION_NAME_1_CONFIG",
     "pinnedVersion": "EXTENSION_NAME_1_VERSION"
  },
   "EXTENSION_NAME_2": {
     "stringConfig": "EXTENSION_NAME_2_CONFIG",
     "pinnedVersion": "EXTENSION_NAME_2_VERSION"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
       "inclusionLabels": {
         "KEY_1": "VALUE_1"
       }
    }
  }
],
"priority": "PRIORITY"
}

Ersetzen Sie Folgendes:

  • FOLDER_ID: Ihre Ordner-ID.
  • ZONE: die Zone, in der diese Richtlinie gilt.
  • POLICY_NAME: ein Name für die VM-Erweiterungsrichtlinie.
  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.
  • EXTENSION_NAME_1, EXTENSION_NAME_2: Der Name der Erweiterung, die der Richtlinie hinzugefügt werden soll. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1_CONFIG, EXTENSION_NAME_2_CONFIG: Die Konfiguration für die Erweiterung, die als Inline-String bereitgestellt wird.
  • EXTENSION_NAME_1_VERSION, EXTENSION_NAME_2_VERSION: Die Version der Erweiterung. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  • KEY_1: VALUE_1: Ein Schlüssel/Wert-Paar, das Einschlusslabels für einen Selektor definiert. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie mehrere instanceSelectors angeben, gilt die Richtlinie für VMs, die mit einem der angegebenen Selektoren übereinstimmen (logisches ODER). Wenn Sie instanceSelectors weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone in allen untergeordneten Projekten im Ordner.
  • PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.

Beispiel: Zonale Richtlinie mit Ordnerbereich erstellen

Im folgenden Beispiel wird eine Richtlinie mit dem Namen folder-test-extension-policy erstellt, die die Erweiterung ops-agent in der Zone us-central1-f für den Ordner 123456 installiert.

POST https://compute.googleapis.com/compute/2026-10-01-preview/folders/123456/zones/us-central1-f/vmExtensionPolicies

{
"name": "folder-test-extension-policy",
"description": "Test extension policy for Ops Agent at folder level",
"extensionPolicies": {
   "ops-agent": {
     "stringConfig": "logging:
      receivers:
        systemd_logs:
          type: systemd_journald
      service:
        pipelines:
          systemd_pipeline:
            receivers: [systemd_logs]",
     "pinnedVersion": "2.58.0"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
       "inclusionLabels": {
         "env": "test"
       }
    }
  }
],
"priority": "500"
}

VM-Erweiterungen in einer Zone in einem Projekt installieren

Erstellen Sie eine zonale Erweiterungsrichtlinie auf Projektebene, um VM-Erweiterungen in einer bestimmten Zone in Ihrem Projekt zu installieren und zu verwalten.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Administrator für Compute-VM-Erweiterungsrichtlinien (roles/compute.vmExtensionPolicyAdmin) für Ihr Projekt zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Erstellen einer projektbezogenen Erweiterungsrichtlinie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.vmExtensionPolicies.create, die zum Erstellen einer projektbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine zonale Erweiterungsrichtlinie auf Projektebene zu erstellen:

Console

Führen Sie die folgenden Schritte aus, um in der Google Cloud Console eine zonale VM-Erweiterungsrichtlinie auf Projektebene zu erstellen:

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

    Zu „VM-Erweiterungsrichtlinien“

  2. Klicken Sie auf Erweiterungsrichtlinie erstellen.
  3. Geben Sie im Feld Name einen Namen für die Richtlinie ein.
  4. Optional: Geben Sie im Feld Beschreibung eine Beschreibung für die Richtlinie ein.
  5. Geben Sie im Feld Priorität eine Prioritätsnummer an, um Konflikte zwischen Richtlinien zu lösen. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000.
  6. Wählen Sie im Abschnitt Bereich die Option Zonaler Roll-out aus.
  7. Wählen Sie in den Listen Region und Zone die Region und Zone aus, in der sich Ihre VMs befinden. VM Extension Manager wendet die Richtlinie auf die VMs in der ausgewählten Region und Zone an.
  8. Klicken Sie im Bereich Erweiterungen verwalten auf Erweiterung hinzufügen und gehen Sie für jede Erweiterung, die Sie auf den Ziel-VMs installieren möchten, so vor:
    1. Wählen Sie in der Liste Erweiterung eine Erweiterung aus. Weitere Informationen finden Sie unter Unterstützte Erweiterungen.
    2. Wählen Sie in der Liste Version die Versionsnummer der Erweiterung aus. Lassen Sie das Feld leer, um die aktuelle Version auszuwählen.
      • Für den Ops-Agent können Sie die Version 2.58.0 oder höher angeben.
      • Lassen Sie das Feld für die Erweiterung für SAP und die Erweiterung für Compute-Arbeitslasten leer, um die aktuelle Version auszuwählen.
    3. Optional: Geben Sie im Feld Inhalt der Konfigurationsdatei Konfigurationsparameter für die Erweiterung ein.
  9. Wählen Sie im Abschnitt Ziel-VM-Instanzen die VMs für die Richtlinie aus. Wenn Sie VMs mit bestimmten Labels auswählen möchten, klicken Sie auf Labels hinzufügen und fügen Sie das Schlüssel/Wert-Paar hinzu.
  10. Klicken Sie auf Erstellen.

gcloud

Wenn Sie eine zonale VM-Erweiterungsrichtlinie auf Projektebene erstellen und die Richtlinie auf VMs in einer bestimmten Zone anwenden möchten, verwenden Sie den Befehl gcloud compute zone-vm-extension-policies create:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

Ersetzen Sie Folgendes:

  • POLICY_NAME: ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: die Projekt-ID für die projektbezogene Richtlinie.
  • ZONE: die Zone, in der diese Richtlinie gilt.
  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.
  • EXTENSION_NAME_1,EXTENSION_NAME_2: Eine durch Kommas getrennte Liste von Erweiterungen, die der Richtlinie hinzugefügt werden sollen. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert die Version der Erweiterung ist. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  • EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert der Pfad zur Konfigurationsdatei für diese Erweiterung ist. Diese Datei befindet sich auf der VM, auf der Sie den Befehl gcloud ausführen, nicht auf der VM, auf der Sie die Erweiterung installieren.

    Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen das Flag --config anstelle von --config-from-file, z. B. EXTENSION_NAME_1="CONFIG_1". Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.

  • KEY_1=VALUE_1: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches ODER). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone in Ihrem Projekt.
  • PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.

Der Befehl schlägt fehl, wenn in der Zone bereits eine Richtlinie mit dem angegebenen Namen vorhanden ist.

Beispiel: Zonale Richtlinie auf Projektebene erstellen

Mit dem folgenden Befehl wird eine Richtlinie mit dem Namen test-extension-policy erstellt, die die Erweiterung ops-agent in der Zone us-central1-f für das Projekt test-project installiert. Das Flag --config-from-file gibt den Pfad zu einer lokalen Datei an, die eine YAML-Konfiguration für den Ops-Agent enthält.

gcloud compute zone-vm-extension-policies create test-extension-policy \
  --project=test-project \
  --zone=us-central1-f \
  --extensions=ops-agent \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml"

Beispiel: Zonale Richtlinie auf Projektebene mit Einschlusslabels und Priorität erstellen

Mit dem folgenden Befehl wird eine Richtlinie namens test-extension-policy-2 erstellt, die die Erweiterung ops-agent in der Zone us-central1-f für das Projekt test-project auf VMs mit dem Label env=prod installiert. Die Richtlinienpriorität ist auf 500 festgelegt und das Flag --config-from-file gibt den Pfad zu einer lokalen Datei an, die eine YAML-Konfiguration für den Ops-Agent enthält.

gcloud compute zone-vm-extension-policies create test-extension-policy-2 \
  --project=test-project \
  --zone=us-central1-f \
  --extensions=ops-agent \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --priority=500 \
  --inclusion-labels=env=prod

REST

Senden Sie eine POST-Anfrage an die Methode zoneVmExtensionPolicies.insert, um eine zonale VM-Erweiterungsrichtlinie auf Projektebene zu erstellen. Mit dieser Methode wird definiert, welche Erweiterungen auf welchen VMs in einer bestimmten Zone installiert werden sollen.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies

{
"name": "POLICY_NAME",
"description": "DESCRIPTION",
"extensionPolicies": {
   "EXTENSION_NAME_1": {
     "stringConfig": "EXTENSION_NAME_1_CONFIG",
     "pinnedVersion": "EXTENSION_NAME_1_VERSION"
  },
   "EXTENSION_NAME_2": {
     "stringConfig": "EXTENSION_NAME_2_CONFIG",
     "pinnedVersion": "EXTENSION_NAME_2_VERSION"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
       "inclusionLabels": {
         "KEY_1": "VALUE_1"
       }
    }
  }
],
"priority": "PRIORITY"
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Projekt-ID.
  • ZONE: die Zone, in der diese Richtlinie gilt.
  • POLICY_NAME: ein Name für die VM-Erweiterungsrichtlinie.
  • DESCRIPTION: eine optionale Beschreibung der Richtlinie.
  • EXTENSION_NAME_1, EXTENSION_NAME_2: Der Name der Erweiterung, die der Richtlinie hinzugefügt werden soll. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1_CONFIG, EXTENSION_NAME_2_CONFIG: Die Konfiguration für die Erweiterung, die als Inline-String bereitgestellt wird.
  • EXTENSION_NAME_1_VERSION, EXTENSION_NAME_2_VERSION: Die Version der Erweiterung. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  • KEY_1: VALUE_1: Ein Schlüssel/Wert-Paar, das Einschlusslabels für einen Selektor definiert. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie mehrere instanceSelectors angeben, gilt die Richtlinie für VMs, die mit einem der angegebenen Selektoren übereinstimmen (logisches ODER). Wenn Sie instanceSelectors weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone in Ihrem Projekt.
  • PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.

Beispiel: Zonale Richtlinie auf Projektebene erstellen

Im folgenden Beispiel wird eine Richtlinie mit dem Namen test-extension-policy erstellt, die die Erweiterung ops-agent in der Zone us-central1-f für my-project installiert.

POST https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-f/vmExtensionPolicies

{
"name": "test-extension-policy",
"description": "Test extension policy for Ops Agent",
"extensionPolicies": {
   "ops-agent": {
     "stringConfig": "logging:
      receivers:
        systemd_logs:
          type: systemd_journald
      service:
        pipelines:
          systemd_pipeline:
            receivers: [systemd_logs]",
     "pinnedVersion": "2.58.0"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
       "inclusionLabels": {
         "env": "test"
       }
    }
  }
],
"priority": "500"
}

Nächste Schritte