Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Betriebssystemrichtlinienzuweisungen mit dem Richtlinien-Orchestrator verwalten

Auf dieser Seite wird beschrieben, wie Sie das Richtlinienorchestrator-Feature in VM Manager verwenden, um Betriebssystemrichtlinienressourcen in verschiedenen Projekten und Zonen in Ihren Ordnern oder Ihrer Organisation zu erstellen, zu aktualisieren oder zu löschen.

Hinweis

Prüfen Sie die Betriebssystemrichtlinien und Zuweisung von Betriebssystemrichtlinien.
Prüfen Sie die OS Config-Kontingente.
Prüfen Sie, ob Sie die Voraussetzungen für die Verwendung des Richtlinienorchestrators erfüllen.
Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren:
Wählen Sie den Tab aus, der Ihrer geplanten Verwendung der Beispiele auf dieser Seite entspricht:
Console

Wenn Sie über die Google Cloud Console auf Google Cloud Dienste und APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.
gcloud
1. Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:
  gcloud init
  Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
  
  Hinweis: Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie gcloud components update ausführen.
Legen Sie eine Standardregion und -zone fest.

REST

Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

Installieren Sie die Google Cloud CLI.

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.

Zuweisungen von Betriebssystemrichtlinien projekt- und zonenübergreifend erstellen oder aktualisieren

Sie können Richtlinien-Orchestratoren erstellen, um Betriebssystemrichtlinien auf ausgewählte Ressourcen in einem Projekt, Ordner oder einer Organisation anzuwenden.

Projekt

Console

So erstellen Sie einen Richtlinien-Orchestrator und wenden Betriebssystemrichtlinien-Zuweisungen in einem Projekt an:

Erstellen Sie auf Ihrem lokalen Client eine Betriebssystemrichtliniendatei oder laden Sie sie herunter. Dabei muss es sich um eine JSON- oder YAML-Datei handeln. Weitere Informationen zum Erstellen von Betriebssystemrichtlinien sowie Beispiel-Betriebssystemrichtlinien finden Sie unter Betriebssystemrichtlinien.
Rufen Sie in der Google Cloud -Console die Seite Betriebssystemrichtlinien auf.
Zu „Betriebssystemrichtlinien“
Klicken Sie in der Aktionsleiste der Google Cloud Console auf die Projektauswahl und wählen Sie das Projekt aus, in dem Sie den Richtlinien-Orchestrator erstellen möchten.
Klicken Sie auf Global erstellen.
Geben Sie einen Namen und eine Beschreibung für den Richtlinien-Orchestrator an. Weitere Informationen zu Namenskonventionen finden Sie unter Namenskonvention für Ressourcen. VM Manager weist dem Richtlinien-Orchestrator eine eindeutige Orchestrator-ID zu. Sie können diese ID bei Bedarf bearbeiten.
Laden Sie im Abschnitt Betriebssystemrichtlinien die Betriebssystemrichtliniendatei hoch.
Optional: Wählen Sie im Bereich Status eine der folgenden Optionen aus, um das Verhalten des Richtlinien-Orchestrators festzulegen:
- ACTIVE: In diesem Status kann der Richtlinienorchestrator Aktionen ausführen, sobald er erstellt wurde.
- STOPPED: Ein in diesem Status erstellter Richtlinien-Orchestrator führt nicht sofort Aktionen aus. Sie können den Richtlinien-Orchestrator später bearbeiten, um seinen Status zu ändern.
Wählen Sie im Feld Aktion die Aktion UPSERT aus.
Geben Sie im Abschnitt Orchestration scope (Orchestrationsbereich) die Ordner und Projekte an, in denen Sie die Betriebssystemrichtlinien bereitstellen möchten. In diesen Feldern dürfen nur die Projekt- und Ordnernummern eingegeben werden, z. B. 123456,7654321.
Wählen Sie die Zonen aus, die die VMs enthalten, auf die Sie die Betriebssystemrichtlinien anwenden möchten. Alternativ können Sie auf Alle auswählen klicken, um die Änderungen der Betriebssystemrichtlinie auf Ressourcen in allen Zonen anzuwenden.
Optional: Geben Sie im Abschnitt Ziel-VM-Instanzen die Ziel-VMs an, auf die Sie die Betriebssystemrichtlinien anwenden möchten.
- Wählen Sie den Namen und die Version des Betriebssystems aus. Weitere Informationen finden Sie unter Zuweisungen von Betriebssystemrichtlinien.
- Sie können die VMs weiter filtern. Geben Sie dazu Einschluss- und Ausschlusslabels an.
  Sie können beispielsweise alle Ubuntu-VMs in Ihrer Testumgebung auswählen und dabei die ausschließen, die Google Kubernetes Engine ausführen, indem Sie Folgendes angeben:
  - Kurzname des Betriebssystems: ubuntu
  - Einschließen: env:test, env:staging
  - Ausschließen: goog-gke-node
Geben Sie einen Rolloutplan für die Zuweisung der Betriebssystemrichtlinie an.
- Geben Sie die Wellengröße an (auch als Unterbrechungsbudget bezeichnet). Beispiel: 10 %.
- Geben Sie die Wartezeit an. Beispiel: 15 Minuten.
Klicken Sie auf Erstellen.

gcloud

So erstellen Sie einen Richtlinien-Orchestrator:

Erstellen oder laden Sie eine Datei für die Zuweisung von Betriebssystemrichtlinien im JSON- oder YAML-Format herunter. Weitere Informationen zu dieser Datei und Beispielzuweisungen von Richtlinien finden Sie unter Zuweisungen von Betriebssystemrichtlinien.
Verwenden Sie den Befehl os-config policy-orchestrators create, um die Zuweisung der Betriebssystemrichtlinie im angegebenen Bereich zu erstellen und bereitzustellen.
```
  gcloud compute os-config policy-orchestrators create ORCHESTRATOR_NAME \
    --policy-type=os_policy_assignment_v1 \
    --policy-file=OS_POLICY_ASSIGNMENT_YAML_FILE \
    --policy-id=POLICY_ID
```
Ersetzen Sie Folgendes:
- ORCHESTRATOR_NAME: Name des Richtlinien-Orchestrators. Weitere Informationen finden Sie im Abschnitt zur Konvention für Ressourcennamen.
- OS_POLICY_ASSIGNMENT_FILE: Der absolute Pfad zur Zuweisungsdatei der Betriebssystemrichtlinie, die Sie im vorherigen Schritt erstellt haben.
- POLICY_ID: eine eindeutige ID für den Richtlinien-Orchestrator. Wenn Sie keinen Wert angeben, weist der Richtlinien-Orchestrator der Orchestrator-Ressource eine eindeutige ID zu.
Beispiel
```
  gcloud compute os-config policy-orchestrators create my-os-policy-orchestrator \
      --policy-type=os_policy_assignment_v1 \
      --policy-file=/downloads/assignment-config.yaml \
      --policy-id=policy-123
```

REST

So erstellen Sie einen Richtlinien-Orchestrator:

Erstellen oder laden Sie eine Zuweisungsdatei für Betriebssystemrichtlinien herunter. Diese Datei muss eine JSON-Datei sein. Weitere Informationen zum Erstellen von Zuweisungen von Betriebssystemrichtlinien oder zum Aufrufen von Beispielzuweisungen von Betriebssystemrichtlinien finden Sie unter Zuweisung von Betriebssystemrichtlinien.

Verwenden Sie je nach Umfang, in dem Sie den Richtlinien-Orchestrator erstellen, eine der folgenden Methoden:

Senden Sie eine POST-Anfrage an die Methode projects.locations.global.policyOrchestrators.create.

Fügen Sie in den Anfragetext die Spezifikationen für die Zuweisung der Betriebssystemrichtlinie aus dem vorherigen Schritt ein.

POST https://osconfig.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/policyOrchestrators

  {
      JSON_OS_POLICY_ORCHESTRATOR
  }

Ersetzen Sie Folgendes:

PROJECT_NUMBER: die numerische ID des Projekts, in dem Sie den Richtlinien-Orchestrator erstellen möchten.
JSON_OS_POLICY_ORCHESTRATOR: Das Policy Orchestrator-Objekt im JSON-Format, das den Orchestrator-Bereich, die orchestrierte Ressource und den Orchestrator-Status definiert. Weitere Informationen zu den Parametern und zum Format finden Sie unter Resource: folders.locations.global.policyOrchestrators.

Beispiel

Wenn Sie beispielsweise eine Zuweisung von Betriebssystemrichtlinien erstellen möchten, die eine von einem Cloud Storage-Bucket heruntergeladene Windows-MSI-Datei installiert, und dafür die Beispielzuweisung einer Betriebssystemrichtlinie verwendet werden soll, führen Sie folgende Schritte aus:

Konvertieren Sie das Beispiel in eine JSON-Datei.

Senden Sie die folgende Anfrage:

POST https://osconfig.googleapis.com/v2/projects/123456/locations/global/policyOrchestrators

{
"action": "UPSERT",
"orchestratedResource": {
  "osPolicyAssignmentV1Payload": {
    "instanceFilter": {
      "inventories": [
        {
          "osShortName": "windows"
        }
      ]
    },
    "osPolicies": [
    {
      "id": "install-msi-policy",
      "mode": "ENFORCEMENT",
      "resourceGroups": [
        {
          "resources": [
            {
              "id": "install-msi",
              "pkg": {
                "desiredState": "INSTALLED",
                "msi": {
                  "source": {
                    "gcs": {
                      "bucket": "my-bucket",
                      "generation": "1619136883923956",
                      "object": "my-app.msi"
                    }
                  }
                }
              }
            }
          ]
        }
      ]
    }
    ],
    "rollout": {
      "disruptionBudget": {
        "fixed": 10
      },
      "minWaitDuration": "300s"
    }
  }
},
"orchestrationScope": {
"selectors": [
  {
     "resourceHierarchySelector": {
        "includedProjects": [
        "projects/87654321",
        "projects/4567890"
        ]
      }
    }
  ]
},
"state": "ACTIVE"
}

Ordner

Console

So erstellen Sie einen Richtlinienorchestrator und wenden Zuweisungen von Betriebssystemrichtlinien in einem Ordner an:

Erstellen Sie auf Ihrem lokalen Client eine Betriebssystemrichtliniendatei oder laden Sie sie herunter. Dabei muss es sich um eine JSON- oder YAML-Datei handeln. Weitere Informationen zum Erstellen von Betriebssystemrichtlinien sowie Beispiel-Betriebssystemrichtlinien finden Sie unter Betriebssystemrichtlinien.
Rufen Sie in der Google Cloud -Console die Seite Betriebssystemrichtlinien auf.
Zu „Betriebssystemrichtlinien“
Klicken Sie in der Aktionsleiste der Google Cloud Console auf die Projektauswahl und wählen Sie den Ordner aus, in dem Sie den Richtlinien-Orchestrator erstellen möchten.
Klicken Sie auf Global erstellen.
Geben Sie einen Namen und eine Beschreibung für den Richtlinien-Orchestrator an. Weitere Informationen zu Namenskonventionen finden Sie unter Namenskonvention für Ressourcen. VM Manager weist dem Richtlinien-Orchestrator eine eindeutige Orchestrator-ID zu. Sie können diese ID bei Bedarf bearbeiten.
Laden Sie im Abschnitt Betriebssystemrichtlinien die Betriebssystemrichtliniendatei hoch.
Optional: Wählen Sie im Bereich Status eine der folgenden Optionen aus, um das Verhalten des Richtlinien-Orchestrators festzulegen:
- ACTIVE: In diesem Status kann der Richtlinienorchestrator Aktionen ausführen, sobald er erstellt wurde.
- STOPPED: Ein in diesem Status erstellter Richtlinien-Orchestrator führt nicht sofort Aktionen aus. Sie können den Richtlinien-Orchestrator später bearbeiten, um seinen Status zu ändern.
Wählen Sie im Feld Aktion die Aktion UPSERT aus.
Geben Sie im Abschnitt Orchestration scope (Orchestrationsbereich) die Ordner und Projekte an, in denen Sie die Betriebssystemrichtlinien bereitstellen möchten. In diesen Feldern dürfen nur die Projekt- und Ordnernummern eingegeben werden, z. B. 123456,7654321.
Wählen Sie die Zonen aus, die die VMs enthalten, auf die Sie die Betriebssystemrichtlinien anwenden möchten. Alternativ können Sie auf Alle auswählen klicken, um die Änderungen der Betriebssystemrichtlinie auf Ressourcen in allen Zonen anzuwenden.
Optional: Geben Sie im Abschnitt Ziel-VM-Instanzen die Ziel-VMs an, auf die Sie die Betriebssystemrichtlinien anwenden möchten.
- Wählen Sie den Namen und die Version des Betriebssystems aus. Weitere Informationen finden Sie unter Zuweisungen von Betriebssystemrichtlinien.
- Sie können die VMs weiter filtern. Geben Sie dazu Einschluss- und Ausschlusslabels an.
  Sie können beispielsweise alle Ubuntu-VMs in Ihrer Testumgebung auswählen und dabei die ausschließen, die Google Kubernetes Engine ausführen, indem Sie Folgendes angeben:
  - Kurzname des Betriebssystems: ubuntu
  - Einschließen: env:test, env:staging
  - Ausschließen: goog-gke-node
Geben Sie einen Rolloutplan für die Zuweisung der Betriebssystemrichtlinie an.
- Geben Sie die Wellengröße an (auch als Unterbrechungsbudget bezeichnet). Beispiel: 10 %.
- Geben Sie die Wartezeit an. Beispiel: 15 Minuten.
Klicken Sie auf Erstellen.

gcloud

So erstellen Sie einen Richtlinien-Orchestrator:

Erstellen oder laden Sie eine Datei für die Zuweisung von Betriebssystemrichtlinien im JSON- oder YAML-Format herunter. Weitere Informationen zu dieser Datei und Beispielzuweisungen von Richtlinien finden Sie unter Zuweisungen von Betriebssystemrichtlinien.
Verwenden Sie den Befehl os-config policy-orchestrators create, um die Zuweisung der Betriebssystemrichtlinie im angegebenen Bereich zu erstellen und bereitzustellen.
```
  gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators create ORCHESTRATOR_NAME \
    --folder=FOLDER_NUMBER \
    --policy-type=os_policy_assignment_v1 \
    --policy-file=OS_POLICY_ASSIGNMENT_YAML_FILE \
    --policy-id=POLICY_ID \
    --include-projects=PROJECT_NUMBERS
```
Ersetzen Sie Folgendes:
- QUOTA_PROJECT_ID: die Projekt-ID des Kontingent- oder Abrechnungsprojekts.
- ORCHESTRATOR_NAME: Name des Richtlinien-Orchestrators. Weitere Informationen finden Sie im Abschnitt zur Konvention für Ressourcennamen.
- FOLDER_NUMBER: Die Ordnernummer des Ordners, in dem Sie den Richtlinien-Orchestrator erstellen möchten.
- OS_POLICY_ASSIGNMENT_FILE: Der absolute Pfad zur Zuweisungsdatei der Betriebssystemrichtlinie, die Sie im vorherigen Schritt erstellt haben.
- POLICY_ID: eine eindeutige ID für den Richtlinien-Orchestrator. Wenn Sie keinen Wert angeben, weist der Richtlinien-Orchestrator der Orchestrator-Ressource eine eindeutige ID zu.
- PROJECT_NUMBERS: Eine Liste der Projekte, auf die Sie die Zuweisungen von Betriebssystemrichtlinien anwenden möchten. Sie müssen die Projektnummern angeben, die eindeutige numerische ID der Projekte.
Beispiel
```
  gcloud --billing-project=my-quota-project compute os-config policy-orchestrators create my-os-policy-orchestrator \
      --folder=123456 \
      --policy-type=os_policy_assignment_v1 \
      --policy-file=/downloads/assignment-config.yaml \
      --policy-id=policy-123 \
      --include-projects=87654321,4567890
```

REST

So erstellen Sie einen Richtlinien-Orchestrator:

Erstellen oder laden Sie eine Zuweisungsdatei für Betriebssystemrichtlinien herunter. Diese Datei muss im JSON-Format vorliegen. Weitere Informationen zum Erstellen von Zuweisungen von Betriebssystemrichtlinien oder zum Aufrufen von Beispielzuweisungen von Betriebssystemrichtlinien finden Sie unter Zuweisung von Betriebssystemrichtlinien.

Verwenden Sie je nach Umfang, in dem Sie den Richtlinien-Orchestrator erstellen, eine der folgenden Methoden:

Senden Sie eine POST-Anfrage an die Methode folders.locations.global.policyOrchestrators.create.

Fügen Sie in den Anfragetext die Spezifikationen für die Zuweisung der Betriebssystemrichtlinie aus dem vorherigen Schritt ein.

POST https://osconfig.googleapis.com/v2/folders/FOLDER_NUMBER/locations/global/policyOrchestrators
-H "x-goog-user-project: QUOTA_PROJECT_ID"

{
  JSON_OS_POLICY_ORCHESTRATOR
}

Ersetzen Sie Folgendes:

QUOTA_PROJECT_ID: die Projekt-ID des Kontingent- oder Abrechnungsprojekts.
FOLDER_NUMBER: Die numerische ID des Ordners, in dem Sie den Richtlinien-Orchestrator erstellen möchten.
JSON_OS_POLICY_ORCHESTRATOR: Das Policy Orchestrator-Objekt im JSON-Format, das den Orchestrator-Bereich, die orchestrierte Ressource und den Orchestrator-Status definiert. Weitere Informationen zu den Parametern und zum Format finden Sie unter Resource: folders.locations.global.policyOrchestrators.

Beispiel

Beispiel in JSON konvertieren

Senden Sie die folgende Anfrage:

POST https://osconfig.googleapis.com/v2/folders/123456/locations/global/policyOrchestrators \
-H "x-goog-user-project: my-quota-project

{
"action": "UPSERT",
"orchestratedResource": {
  "osPolicyAssignmentV1Payload": {
    "instanceFilter": {
      "inventories": [
        {
          "osShortName": "windows"
        }
      ]
    },
    "osPolicies": [
    {
      "id": "install-msi-policy",
      "mode": "ENFORCEMENT",
      "resourceGroups": [
        {
          "resources": [
            {
              "id": "install-msi",
              "pkg": {
                "desiredState": "INSTALLED",
                "msi": {
                  "source": {
                    "gcs": {
                      "bucket": "my-bucket",
                      "generation": "1619136883923956",
                      "object": "my-app.msi"
                    }
                  }
                }
              }
            }
          ]
        }
      ]
    }
    ],
    "rollout": {
      "disruptionBudget": {
        "fixed": 10
      },
      "minWaitDuration": "300s"
    }
  }
},
"orchestrationScope": {
"selectors": [
  {
     "resourceHierarchySelector": {
        "includedProjects": [
        "projects/87654321",
        "projects/4567890"
        ]
      }
    }
  ]
},
"state": "ACTIVE"
}

Organisation

Console

So erstellen Sie einen Richtlinien-Orchestrator und wenden Betriebssystemrichtlinien-Zuweisungen in einer Organisation an:

Erstellen Sie auf Ihrem lokalen Client eine Betriebssystemrichtliniendatei oder laden Sie sie herunter. Dabei muss es sich um eine JSON- oder YAML-Datei handeln. Weitere Informationen zum Erstellen von Betriebssystemrichtlinien sowie Beispiel-Betriebssystemrichtlinien finden Sie unter Betriebssystemrichtlinien.
Rufen Sie in der Google Cloud -Console die Seite Betriebssystemrichtlinien auf.
Zu „Betriebssystemrichtlinien“
Klicken Sie in der Aktionsleiste der Google Cloud Console auf die Projektauswahl und wählen Sie die Organisation aus, in der Sie den Richtlinien-Orchestrator erstellen möchten.
Klicken Sie auf Global erstellen.
Geben Sie einen Namen und eine Beschreibung für den Richtlinien-Orchestrator an. Weitere Informationen zu Namenskonventionen finden Sie unter Namenskonvention für Ressourcen. VM Manager weist dem Richtlinien-Orchestrator eine eindeutige Orchestrator-ID zu. Sie können diese ID bei Bedarf bearbeiten.
Laden Sie im Abschnitt Betriebssystemrichtlinien die Betriebssystemrichtliniendatei hoch.
Optional: Wählen Sie im Bereich Status eine der folgenden Optionen aus, um das Verhalten des Richtlinien-Orchestrators festzulegen:
- ACTIVE: In diesem Status kann der Richtlinienorchestrator Aktionen ausführen, sobald er erstellt wurde.
- STOPPED: Ein in diesem Status erstellter Richtlinien-Orchestrator führt nicht sofort Aktionen aus. Sie können den Richtlinien-Orchestrator später bearbeiten, um seinen Status zu ändern.
Wählen Sie im Feld Aktion die Aktion UPSERT aus.
Geben Sie im Abschnitt Orchestration scope (Orchestrationsbereich) die Ordner und Projekte an, in denen Sie die Betriebssystemrichtlinien bereitstellen möchten. In diesen Feldern dürfen nur die Projekt- und Ordnernummern eingegeben werden, z. B. 123456,7654321.
Wählen Sie die Zonen aus, die die VMs enthalten, auf die Sie die Betriebssystemrichtlinien anwenden möchten. Alternativ können Sie auf Alle auswählen klicken, um die Änderungen der Betriebssystemrichtlinie auf Ressourcen in allen Zonen anzuwenden.
Optional: Geben Sie im Abschnitt Ziel-VM-Instanzen die Ziel-VMs an, auf die Sie die Betriebssystemrichtlinien anwenden möchten.
- Wählen Sie den Namen und die Version des Betriebssystems aus. Weitere Informationen finden Sie unter Zuweisungen von Betriebssystemrichtlinien.
- Sie können die VMs weiter filtern. Geben Sie dazu Einschluss- und Ausschlusslabels an.
  Sie können beispielsweise alle Ubuntu-VMs in Ihrer Testumgebung auswählen und dabei die ausschließen, die Google Kubernetes Engine ausführen, indem Sie Folgendes angeben:
  - Kurzname des Betriebssystems: ubuntu
  - Einschließen: env:test, env:staging
  - Ausschließen: goog-gke-node
Geben Sie einen Rolloutplan für die Zuweisung der Betriebssystemrichtlinie an.
- Geben Sie die Wellengröße an (auch als Unterbrechungsbudget bezeichnet). Beispiel: 10 %.
- Geben Sie die Wartezeit an. Beispiel: 15 Minuten.
Klicken Sie auf Erstellen.

gcloud

So erstellen Sie einen Richtlinien-Orchestrator:

Erstellen oder laden Sie eine Ressource für eine Betriebssystemrichtlinie im JSON- oder YAML-Format herunter. Weitere Informationen zu dieser Datei und Beispielzuweisungen von Richtlinien finden Sie unter Zuweisungen von Betriebssystemrichtlinien.
Verwenden Sie den Befehl os-config policy-orchestrators create, um die Zuweisung der Betriebssystemrichtlinie im angegebenen Bereich zu erstellen und bereitzustellen.
```
  gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators create ORCHESTRATOR_NAME \
    --organization=ORGANIZATION_NUMBER \
    --policy-type=os_policy_assignment_v1 \
    --policy-file=OS_POLICY_ASSIGNMENT_YAML_FILE \
    --policy-id=POLICY_ID \
    --include-projects=PROJECT_NUMBERS
```
Ersetzen Sie Folgendes:
- QUOTA_PROJECT_ID: die Projekt-ID des Kontingent- oder Abrechnungsprojekts.
- ORCHESTRATOR_NAME: Name des Richtlinien-Orchestrators. Weitere Informationen finden Sie im Abschnitt zur Konvention für Ressourcennamen.
- FOLDER_NUMBER: Die Ordnernummer des Ordners, in dem Sie den Richtlinien-Orchestrator erstellen möchten.
- OS_POLICY_ASSIGNMENT_FILE: Der absolute Pfad zur Zuweisungsdatei der Betriebssystemrichtlinie, die Sie im vorherigen Schritt erstellt haben.
- POLICY_ID: eine eindeutige ID für den Richtlinien-Orchestrator. Wenn Sie keinen Wert angeben, weist der Richtlinien-Orchestrator der Orchestrator-Ressource eine eindeutige ID zu.
- PROJECT_NUMBERS: Eine Liste der Projekte, auf die Sie die Zuweisungen von Betriebssystemrichtlinien anwenden möchten. Sie müssen die Projektnummern angeben, die eindeutige numerische ID der Projekte.
Beispiel
```
  gcloud --billing-project=my-quota-project compute os-config policy-orchestrators create my-os-policy-orchestrator \
      --organization=123456 \
      --policy-type=os_policy_assignment_v1 \
      --policy-file=/downloads/assignment-config.yaml \
      --policy-id=policy-123 \
      --include-projects=87654321,4567890
```

REST

So erstellen Sie einen Richtlinien-Orchestrator:

Erstellen oder laden Sie eine Zuweisungsdatei für Betriebssystemrichtlinien herunter. Diese Datei muss eine JSON-Datei sein. Weitere Informationen zum Erstellen von Zuweisungen von Betriebssystemrichtlinien oder zum Aufrufen von Beispielzuweisungen von Betriebssystemrichtlinien finden Sie unter Zuweisung von Betriebssystemrichtlinien.

Verwenden Sie je nach Umfang, in dem Sie den Richtlinien-Orchestrator erstellen, eine der folgenden Methoden:

Senden Sie eine POST-Anfrage an die Methode organizations.locations.global.policyOrchestrators.create.

Fügen Sie in den Anfragetext die Spezifikationen für die Zuweisung der Betriebssystemrichtlinie aus dem vorherigen Schritt ein.

POST https://osconfig.googleapis.com/v2/organizations/ORGANIZATION_NUMBER/locations/global/policyOrchestrators \
-H "x-goog-user-project: QUOTA_PROJECT_ID"

  {
      JSON_OS_POLICY_ORCHESTRATOR
  }

Ersetzen Sie Folgendes:

QUOTA_PROJECT_ID: die Projekt-ID des Kontingent- oder Abrechnungsprojekts.
ORGANIZATION_NUMBER: Die numerische ID der Organisation, in der Sie den Richtlinien-Orchestrator erstellen möchten.
JSON_OS_POLICY_ORCHESTRATOR: Das Policy Orchestrator-Objekt im JSON-Format, das den Orchestrator-Bereich, die orchestrierte Ressource und den Orchestrator-Status definiert. Weitere Informationen zu den Parametern und zum Format finden Sie unter Resource: organizations.locations.global.policyOrchestrators.

Beispiel

Beispiel in JSON konvertieren

Senden Sie die folgende Anfrage:

POST https://osconfig.googleapis.com/v2/organizations/567890/locations/global/policyOrchestrators \
-H "x-goog-user-project: my-quota-project
{
"action": "UPSERT",
"orchestratedResource": {
  "osPolicyAssignmentV1Payload": {
    "instanceFilter": {
      "inventories": [
        {
          "osShortName": "windows"
        }
      ]
    },
    "osPolicies": [
    {
      "id": "install-msi-policy",
      "mode": "ENFORCEMENT",
      "resourceGroups": [
        {
          "resources": [
            {
              "id": "install-msi",
              "pkg": {
                "desiredState": "INSTALLED",
                "msi": {
                  "source": {
                    "gcs": {
                      "bucket": "my-bucket",
                      "generation": "1619136883923956",
                      "object": "my-app.msi"
                    }
                  }
                }
              }
            }
          ]
        }
      ]
    }
    ],
    "rollout": {
      "disruptionBudget": {
        "fixed": 10
      },
      "minWaitDuration": "300s"
    }
  }
},
"orchestrationScope": {
"selectors": [
  {
     "resourceHierarchySelector": {
        "includedProjects": [
        "projects/87654321",
        "projects/4567890"
        ]
      }
    }
  ]
},
"state": "ACTIVE"
}

Zuweisungen von Betriebssystemrichtlinien aus mehreren Projekten löschen

Mit dem Richtlinienorchestrator können Sie Betriebssystemrichtlinien aus mehreren Projekten in Ihrem Ordner oder Ihrer Organisation löschen, indem Sie die eindeutige Richtlinien-ID für die Betriebssystemrichtlinienressource angeben.

Projekt

Console

So löschen Sie Zuweisungen von Betriebssystemrichtlinien in einem Projekt:

Erstellen Sie auf Ihrem lokalen Client eine Betriebssystemrichtliniendatei oder laden Sie sie herunter. Dabei muss es sich um eine JSON- oder YAML-Datei handeln. Weitere Informationen zum Erstellen von Betriebssystemrichtlinien sowie Beispiel-Betriebssystemrichtlinien finden Sie unter Betriebssystemrichtlinien.
Rufen Sie in der Google Cloud -Console die Seite Betriebssystemrichtlinien auf.
Zu „Betriebssystemrichtlinien“
Klicken Sie in der Aktionsleiste der Google Cloud Console auf die Projektauswahl und wählen Sie das Projekt aus, aus dem Sie Zuweisungen von Betriebssystemrichtlinien löschen möchten.
Klicken Sie auf Global erstellen.
Geben Sie einen Namen und eine Beschreibung für den Richtlinien-Orchestrator an. Weitere Informationen finden Sie im Abschnitt zur Namenskonvention für Ressourcen. VM Manager weist dem Richtlinien-Orchestrator eine eindeutige Orchestrator-ID zu. Sie können diese ID bei Bedarf bearbeiten.
Wählen Sie im Abschnitt Betriebssystemrichtlinien die Betriebssystemrichtliniendatei aus, die Sie löschen möchten, und laden Sie sie hoch.
Optional: Wählen Sie im Bereich Status eine der folgenden Optionen aus, um das Verhalten des Richtlinien-Orchestrators festzulegen:
- ACTIVE: In diesem Status kann der Richtlinienorchestrator Aktionen ausführen, sobald er erstellt wurde.
- STOPPED: Ein Richtlinienorchestrator, der in diesem Status erstellt wird, führt nicht sofort Aktionen aus. Sie können den Richtlinien-Orchestrator später bearbeiten, um seinen Status zu ändern.
Wählen Sie im Feld Aktion die Aktion DELETE aus.
Geben Sie im Abschnitt Orchestration scope (Orchestrierungsbereich) die Ordner und Projekte an, aus denen Sie die Zuweisungen von Betriebssystemrichtlinien löschen möchten. Geben Sie in diesen Feldern nur die Projekt- und Ordnernummern ein, z. B. 123456,7654321.
Wählen Sie die Zonen aus, die die VMs enthalten, aus denen Sie Zuweisungen von Betriebssystemrichtlinien löschen möchten.
Optional: Geben Sie im Abschnitt Ziel-VM-Instanzen die Ziel-VMs an, aus denen Sie Zuweisungen von Betriebssystemrichtlinien löschen möchten.
- Wählen Sie die Betriebssystemfamilien aus.
- Sie können die VMs weiter filtern. Geben Sie dazu Einschluss- und Ausschlusslabels an.
  Sie können beispielsweise alle Ubuntu-VMs in Ihrer Testumgebung auswählen und dabei die ausschließen, die Google Kubernetes Engine ausführen, indem Sie Folgendes angeben:
  - Kurzname des Betriebssystems: ubuntu
  - Einschließen: env:test, env:staging
  - Ausschließen: goog-gke-node
Geben Sie einen Rolloutplan zum Löschen der Zuweisung von Betriebssystemrichtlinien an.
- Geben Sie die Wellengröße an (auch als Unterbrechungsbudget bezeichnet). Beispiel: 10 %.
- Geben Sie die Wartezeit an. Beispiel: 15 Minuten.
Klicken Sie auf Erstellen.

gcloud

Wenn Sie Betriebssystemrichtlinien aus mehreren Projekten mit einem Richtlinienorchestrator löschen möchten, verwenden Sie den Befehl os-config policy-orchestrators create und geben Sie die Aktion als delete für die policy-id an, die mit der Zuweisung der Betriebssystemrichtlinie verknüpft ist.

    gcloud compute os-config policy-orchestrators create ORCHESTRATOR_NAME \
      --policy-type=os_policy_assignment_v1 \
      --policy-file=OS_POLICY_ASSIGNMENT_FILE \
      --policy-id=POLICY_ID \
      --action=delete

Ersetzen Sie Folgendes:

ORCHESTRATOR_NAME: Name des Richtlinien-Orchestrators.
OS_POLICY_ASSIGNMENT_FILE: Der absolute Pfad zur Zuweisungsdatei der Betriebssystemrichtlinie.
POLICY_ID: die Richtlinien-ID für die Orchestratorressource für Betriebssystemrichtlinien.

Beispiel

   gcloud compute os-config policy-orchestrators create my-os-policy-orchestrator \
     --policy-type=os_policy_assignment_v1
     --policy-id=my-policy \
     --action=delete

REST

Wenn Sie einen Richtlinienorchestrator erstellen möchten, der Betriebssystemrichtlinien aus mehreren Projekten löscht, verwenden Sie eine der folgenden Methoden und geben Sie die Aktion als DELETE an:

Senden Sie eine POST-Anfrage an die Methode projects.locations.global.policyOrchestrators.create.

Geben Sie im Anfragetext die Richtlinien-ID an, die mit der Zuweisung der Betriebssystemrichtlinie verknüpft ist.

  POST https://osconfig.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/policyOrchestrators

    {
        JSON_OS_POLICY_ORCHESTRATOR
    }

Ersetzen Sie Folgendes:

PROJECT_NUMBER: die numerische ID des Projekts, in dem Sie den Richtlinien-Orchestrator erstellen möchten.

JSON_OS_POLICY_ORCHESTRATOR: Das Policy Orchestrator-Objekt im JSON-Format, das den Orchestrator-Bereich, die orchestrierte Ressource und den Orchestrator-Status definiert. Weitere Informationen zu den Parametern und zum Format finden Sie unter Resource: folders.locations.global.policyOrchestrators.

Beispiel

POST https://osconfig.googleapis.com/v2/projects/567890/locations/global/policyOrchestrators

{
  "action": "DELETE",
  "orchestratedResource": {
    "id": "my-policy",
    "osPolicyAssignmentV1Payload": {}
  },
  "orchestrationScope": {
    "selectors": [
      {
        "resourceHierarchySelector": {
          "includedProjects": [
            "projects/87654321",
            "projects/4567890"
          ]
        }
      }
    ]
  },
  "state": "ACTIVE"
}

Ordner

Console

So löschen Sie Zuweisungen von Betriebssystemrichtlinien in einem Ordner:

Erstellen Sie auf Ihrem lokalen Client eine Betriebssystemrichtliniendatei oder laden Sie sie herunter. Dabei muss es sich um eine JSON- oder YAML-Datei handeln. Weitere Informationen zum Erstellen von Betriebssystemrichtlinien sowie Beispiel-Betriebssystemrichtlinien finden Sie unter Betriebssystemrichtlinien.
Rufen Sie in der Google Cloud -Console die Seite Betriebssystemrichtlinien auf.
Zu „Betriebssystemrichtlinien“
Klicken Sie in der Aktionsleiste der Google Cloud Console auf die Projektauswahl und wählen Sie den Ordner aus, aus dem Sie Zuweisungen von Betriebssystemrichtlinien löschen möchten.
Klicken Sie auf Global erstellen.
Geben Sie einen Namen und eine Beschreibung für den Richtlinien-Orchestrator an. Weitere Informationen finden Sie im Abschnitt zur Namenskonvention für Ressourcen. VM Manager weist dem Richtlinien-Orchestrator eine eindeutige Orchestrator-ID zu. Sie können diese ID bei Bedarf bearbeiten.
Wählen Sie im Abschnitt Betriebssystemrichtlinien die Betriebssystemrichtliniendatei aus, die Sie löschen möchten, und laden Sie sie hoch.
Optional: Wählen Sie im Bereich Status eine der folgenden Optionen aus, um das Verhalten des Richtlinien-Orchestrators festzulegen:
- ACTIVE: In diesem Status kann der Richtlinienorchestrator Aktionen ausführen, sobald er erstellt wurde.
- STOPPED: Ein Richtlinienorchestrator, der in diesem Status erstellt wird, führt nicht sofort Aktionen aus. Sie können den Richtlinien-Orchestrator später bearbeiten, um seinen Status zu ändern.
Wählen Sie im Feld Aktion die Aktion DELETE aus.
Geben Sie im Abschnitt Orchestration scope (Orchestrierungsbereich) die Ordner und Projekte an, aus denen Sie die Zuweisungen von Betriebssystemrichtlinien löschen möchten. Geben Sie in diesen Feldern nur die Projekt- und Ordnernummern ein, z. B. 123456,7654321.
Wählen Sie die Zonen aus, die die VMs enthalten, aus denen Sie Zuweisungen von Betriebssystemrichtlinien löschen möchten.
Optional: Geben Sie im Abschnitt Ziel-VM-Instanzen die Ziel-VMs an, aus denen Sie Zuweisungen von Betriebssystemrichtlinien löschen möchten.
- Wählen Sie die Betriebssystemfamilien aus.
- Sie können die VMs weiter filtern. Geben Sie dazu Einschluss- und Ausschlusslabels an.
  Sie können beispielsweise alle Ubuntu-VMs in Ihrer Testumgebung auswählen und dabei die ausschließen, die Google Kubernetes Engine ausführen, indem Sie Folgendes angeben:
  - Kurzname des Betriebssystems: ubuntu
  - Einschließen: env:test, env:staging
  - Ausschließen: goog-gke-node
Geben Sie einen Rolloutplan zum Löschen der Zuweisung von Betriebssystemrichtlinien an.
- Geben Sie die Wellengröße an (auch als Unterbrechungsbudget bezeichnet). Beispiel: 10 %.
- Geben Sie die Wartezeit an. Beispiel: 15 Minuten.
Klicken Sie auf Erstellen.

gcloud

    gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators create ORCHESTRATOR_NAME \
      --policy-type=os_policy_assignment_v1 \
      --policy-id=POLICY_ID \
      --action=delete

Ersetzen Sie Folgendes:

QUOTA_PROJECT_ID: die Projekt-ID des Kontingent- oder Abrechnungsprojekts.
ORCHESTRATOR_NAME: Name des Richtlinien-Orchestrators.
FOLDER_NUMBER: Die numerische ID des Ordners, aus dem Sie die Betriebssystemrichtlinienressourcen löschen möchten.
POLICY_ID: die Richtlinien-ID für die Orchestratorressource für Betriebssystemrichtlinien.

Beispiel

  gcloud --billing-project=my-quota-project compute os-config policy-orchestrators create my-os-policy-orchestrator \
    --folder=123456 \
    --policy-type=os_policy_assignment_v1 \
    --policy-id=my-policy \
    --action=delete

REST

Senden Sie eine POST-Anfrage an die Methode folders.locations.global.policyOrchestrators.create.

Geben Sie im Anfragetext die Richtlinien-ID an, die mit der Zuweisung der Betriebssystemrichtlinie verknüpft ist.

 POST https://osconfig.googleapis.com/v2/folders/FOLDER_NUMBER/locations/global/policyOrchestrators
-H "x-goog-user-project: QUOTA_PROJECT_ID"

 {
    JSON_OS_POLICY_ORCHESTRATOR
 }

Ersetzen Sie Folgendes:

QUOTA_PROJECT_ID: die Projekt-ID des Kontingent- oder Abrechnungsprojekts.
FOLDER_NUMBER: Die numerische ID des Ordners, aus dem Sie die Betriebssystemrichtlinienressourcen löschen möchten.
JSON_OS_POLICY_ORCHESTRATOR: Das Policy Orchestrator-Objekt im JSON-Format, das die Richtlinien-ID, den Orchestrator-Bereich, die orchestrierte Ressource und den Orchestrierungsstatus definiert. Weitere Informationen zu den Parametern und zum Format finden Sie unter Resource: folders.locations.global.policyOrchestrators.

Beispiel

Wenn Sie beispielsweise Betriebssystemrichtlinien-Ressourcen aus mehreren Projekten löschen möchten, stellen Sie die folgende Anfrage:

   POST https://osconfig.googleapis.com/v2/folders/567890/locations/global/policyOrchestrators
   -H "x-goog-user-project: my-quota-project

{
      "action": "DELETE",
      "orchestratedResource": {
        "id": "my-policy",
        "osPolicyAssignmentV1Payload": {}
      },
      "orchestrationScope": {
        "selectors": [
          {
            "resourceHierarchySelector": {
              "includedProjects": [
                "projects/87654321",
                "projects/4567890"
              ]
            }
          }
        ]
      },
      "state": "ACTIVE"
    }

Organisation

Console

So löschen Sie Zuweisungen von Betriebssystemrichtlinien in einer Organisation:

Erstellen Sie auf Ihrem lokalen Client eine Betriebssystemrichtliniendatei oder laden Sie sie herunter. Dabei muss es sich um eine JSON- oder YAML-Datei handeln. Weitere Informationen zum Erstellen von Betriebssystemrichtlinien sowie Beispiel-Betriebssystemrichtlinien finden Sie unter Betriebssystemrichtlinien.
Rufen Sie in der Google Cloud -Console die Seite Betriebssystemrichtlinien auf.
Zu „Betriebssystemrichtlinien“
Klicken Sie in der Aktionsleiste der Google Cloud Console auf die Projektauswahl und wählen Sie die Organisation aus, aus der Sie Zuweisungen von Betriebssystemrichtlinien löschen möchten.
Klicken Sie auf Global erstellen.
Geben Sie einen Namen und eine Beschreibung für den Richtlinien-Orchestrator an. Weitere Informationen finden Sie im Abschnitt zur Namenskonvention für Ressourcen. VM Manager weist dem Richtlinien-Orchestrator eine eindeutige Orchestrator-ID zu. Sie können diese ID bei Bedarf bearbeiten.
Wählen Sie im Abschnitt Betriebssystemrichtlinien die Betriebssystemrichtliniendatei aus, die Sie löschen möchten, und laden Sie sie hoch.
Optional: Wählen Sie im Bereich Status eine der folgenden Optionen aus, um das Verhalten des Richtlinien-Orchestrators festzulegen:
- ACTIVE: In diesem Status kann der Richtlinienorchestrator Aktionen ausführen, sobald er erstellt wurde.
- STOPPED: Ein Richtlinienorchestrator, der in diesem Status erstellt wird, führt nicht sofort Aktionen aus. Sie können den Richtlinien-Orchestrator später bearbeiten, um seinen Status zu ändern.
Wählen Sie im Feld Aktion die Aktion DELETE aus.
Geben Sie im Abschnitt Orchestration scope (Orchestrierungsbereich) die Ordner und Projekte an, aus denen Sie die Zuweisungen von Betriebssystemrichtlinien löschen möchten. Geben Sie in diesen Feldern nur die Projekt- und Ordnernummern ein, z. B. 123456,7654321.
Wählen Sie die Zonen aus, die die VMs enthalten, aus denen Sie Zuweisungen von Betriebssystemrichtlinien löschen möchten.
Optional: Geben Sie im Abschnitt Ziel-VM-Instanzen die Ziel-VMs an, aus denen Sie Zuweisungen von Betriebssystemrichtlinien löschen möchten.
- Wählen Sie die Betriebssystemfamilien aus.
- Sie können die VMs weiter filtern. Geben Sie dazu Einschluss- und Ausschlusslabels an.
  Sie können beispielsweise alle Ubuntu-VMs in Ihrer Testumgebung auswählen und dabei die ausschließen, die Google Kubernetes Engine ausführen, indem Sie Folgendes angeben:
  - Kurzname des Betriebssystems: ubuntu
  - Einschließen: env:test, env:staging
  - Ausschließen: goog-gke-node
Geben Sie einen Rolloutplan zum Löschen der Zuweisung von Betriebssystemrichtlinien an.
- Geben Sie die Wellengröße an (auch als Unterbrechungsbudget bezeichnet). Beispiel: 10 %.
- Geben Sie die Wartezeit an. Beispiel: 15 Minuten.
Klicken Sie auf Erstellen.

gcloud

  gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators create ORCHESTRATOR_NAME \
    --organization=ORGANIZATION_NUMBER \
    --policy-type=os_policy_assignment_v1 \
    --policy-id=POLICY_ID \
    --action=delete

Ersetzen Sie Folgendes:

QUOTA_PROJECT_ID: die Projekt-ID des Kontingent- oder Abrechnungsprojekts.
ORCHESTRATOR_NAME: Name des Richtlinien-Orchestrators.
ORGANIZATION_NUMBER: die numerische ID der Organisation, aus der Sie die Betriebssystemrichtlinienressourcen löschen möchten.
POLICY_ID: die Richtlinien-ID für die Orchestratorressource für Betriebssystemrichtlinien.

Beispiel

  gcloud --billing-project=my-quota-project compute os-config policy-orchestrators create my-os-policy-orchestrator \
    --organization=987654321
    --policy-type=os_policy_assignment_v1
    --policy-id=my-policy \
    --action=delete

REST

Senden Sie eine POST-Anfrage an die Methode organizations.locations.global.policyOrchestrators.create.

Geben Sie im Anfragetext die Richtlinien-ID an, die mit der Zuweisung der Betriebssystemrichtlinie verknüpft ist.

 POST https://osconfig.googleapis.com/v2/organizations/ORGANIZATION_NUMBER/locations/global/policyOrchestrators
-H "x-goog-user-project: QUOTA_PROJECT_ID"

{
    JSON_OS_POLICY_ORCHESTRATOR
}

Ersetzen Sie Folgendes:

QUOTA_PROJECT_ID: die Projekt-ID des Kontingent- oder Abrechnungsprojekts.
ORGANIZATION_NUMBER: die numerische ID der Organisation, aus der Sie die Betriebssystemrichtlinienressourcen löschen möchten.
JSON_OS_POLICY_ORCHESTRATOR: Das Policy Orchestrator-Objekt im JSON-Format, das die Richtlinien-ID, den Orchestrator-Bereich, die orchestrierte Ressource und den Orchestrierungsstatus definiert. Weitere Informationen zu den Parametern und zum Format finden Sie unter Resource: organizations.locations.global.policyOrchestrators.

Beispiel

Wenn Sie beispielsweise Betriebssystemrichtlinien-Ressourcen aus mehreren Projekten löschen möchten, senden Sie die folgende Anfrage:

  POST https://osconfig.googleapis.com/v2/organizations/567890/locations/global/policyOrchestrators
  -H "x-goog-user-project: my-quota-project

{
      "action": "DELETE",
      "orchestratedResource": {
        "id": "my-policy",
        "osPolicyAssignmentV1Payload": {}
      },
      "orchestrationScope": {
        "selectors": [
          {
            "resourceHierarchySelector": {
              "includedProjects": [
                "projects/87654321",
                "projects/4567890"
              ]
            }
          }
        ]
      },
      "state": "ACTIVE"
    }

Betriebssystemrichtlinienzuweisungen mit dem Richtlinien-Orchestrator verwalten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweis

Console

gcloud

REST

Zuweisungen von Betriebssystemrichtlinien projekt- und zonenübergreifend erstellen oder aktualisieren

Projekt

Console

gcloud

REST

Ordner

Console

gcloud

REST

Organisation

Console

gcloud

REST

Zuweisungen von Betriebssystemrichtlinien aus mehreren Projekten löschen

Projekt

Console

gcloud

REST

Ordner

Console

gcloud

REST

Organisation

Console

gcloud

REST

Nächste Schritte

Betriebssystemrichtlinienzuweisungen mit dem Richtlinien-Orchestrator verwalten