Benutzerdefinierte Einschränkungen für Organisationsrichtlinien erstellen

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Cloud Composer 3 | Cloud Composer 2 | Cloud Composer 1

Auf dieser Seite erfahren Sie, wie Sie mithilfe von benutzerdefinierten Einschränkungen des Organisationsrichtliniendienstes bestimmte Vorgänge für die folgenden Google Cloud Ressourcen einschränken:

• composer.googleapis.com/Environment

Weitere Informationen zu Organisationsrichtlinien finden Sie unter Benutzerdefinierte Organisationsrichtlinien.

Informationen zu Organisationsrichtlinien und Einschränkungen

Mit dem Google Cloud Organisationsrichtliniendienst können Sie die Ressourcen Ihrer Organisation zentral und programmatisch steuern. Als Administrator für Organisationsrichtlinien können Sie eine Organisationsrichtlinie definieren, also eine Reihe von Einschränkungen, die fürGoogle Cloud -Ressourcen und untergeordnete Elemente dieser Ressourcen in der Google Cloud -Ressourcenhierarchie gelten. Sie können Organisationsrichtlinien auf Organisations-, Ordner- oder Projektebene erzwingen.

Die Organisationsrichtlinie bietet vordefinierte Einschränkungen für verschiedene Google Cloud Dienste. Wenn Sie jedoch eine detailliertere, anpassbare Steuerung der spezifischen Felder wünschen, die in Ihren Organisationsrichtlinien eingeschränkt werden, können Sie auch benutzerdefinierte Einschränkungen erstellen und diese benutzerdefinierten Einschränkungen in einer Organisationsrichtlinie verwenden.

Übernahme von Richtlinien

Standardmäßig werden Organisationsrichtlinien von den Nachfolgerelementen der Ressourcen übernommen, für die Sie die Richtlinie erzwingen. Wenn Sie beispielsweise eine Richtlinie für einen Ordner erzwingen, erzwingt Google Cloud die Richtlinie für alle Projekte in dem Ordner. Weitere Informationen zu diesem Verhalten und zu dessen Änderung finden Sie unter Regeln für die Evaluierung der Hierarchie.

Vorteile

Mit benutzerdefinierten Organisationsrichtlinien können Sie bestimmte Werte für Cloud Composer-Ressourcen zulassen oder ablehnen. Wenn beispielsweise eine Anfrage zum Erstellen oder Aktualisieren einer Cloud Composer-Umgebung die benutzerdefinierte Validierung von Einschränkungen, die in Ihrer Organisationsrichtlinie festgelegt ist, nicht erfüllt, schlägt die Anfrage fehl und der Aufrufer erhält eine Fehlermeldung. Außerdem haben benutzerdefinierte Organisationsrichtlinien folgende Vorteile:

1. Verbessert die Sicherheit. Sie können beispielsweise Richtlinien definieren, die das Erstellen von Umgebungen mit öffentlichen IP-Adressen verbieten, privat verwendete öffentliche IP-Adressen zulassen oder die Verwendung eines bestimmten Netzwerks und Subnetzwerks angeben.

2. Bietet eine detaillierte Kontrolle über Ressourcen, die beim Erstellen oder Aktualisieren einer Umgebung erstellt oder verwendet werden.

Beschränkungen

Wie alle Einschränkungen für Organisationsrichtlinien gelten Richtlinienänderungen nicht rückwirkend für vorhandene Instanzen.

• Eine neue Richtlinie hat keine Auswirkungen auf vorhandene Instanzkonfigurationen.
• Eine vorhandene Instanzkonfiguration bleibt gültig, es sei denn, Sie ändern sie über die Google Cloud Console, die Google Cloud CLI oder RPC von einem konformen zu einem nicht konformen Wert.

Bevor Sie benutzerdefinierte Organisationsrichtlinien für den UPDATE-Methodentyp der Ressource erzwingen, prüfen Sie, ob die vorhandenen Umgebungen den einzelnen Richtlinien entsprechen.

Da mit einem Aktualisierungsvorgang nur ein Feld aktualisiert werden kann, kann es zu einem Deadlock kommen, wenn mehrere Felder einer vorhandenen Umgebung gleichzeitig gegen die Richtlinien verstoßen.

Führen Sie einen der folgenden Schritte aus, um eine Deadlock-Situation zu vermeiden:

• (Empfohlen) Sorgen Sie dafür, dass alle vorhandenen Umgebungen einer Richtlinie entsprechen, bevor Sie die Richtlinie auf die Ressourcen erzwingen. Mit dem Policy Simulator können Sie prüfen, welche der vorhandenen Umgebungen nach der Erzwingung der Richtlinie nicht mehr konform sind.

• Deaktivieren Sie die Durchsetzung der Richtlinie, aktualisieren Sie vorhandene Umgebungen auf den konformen Status und erzwingen Sie die Richtlinie noch einmal.

Hinweise

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Install the Google Cloud CLI.

5. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

8. Make sure that billing is enabled for your Google Cloud project.

9. Install the Google Cloud CLI.

10. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

12. Sie müssen Ihre Organisations-ID kennen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Organization policy administrator (roles/orgpolicy.policyAdmin) für die Organisationsressource zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Verwalten benutzerdefinierter Organisationsrichtlinien benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Benutzerdefinierte Einschränkung erstellen

Eine benutzerdefinierte Einschränkung wird in einer YAML-Datei durch die Ressourcen, Methoden, Bedingungen und Aktionen definiert, die von dem Dienst unterstützt werden, für den Sie die Organisationsrichtlinie erzwingen. Bedingungen für Ihre benutzerdefinierten Einschränkungen werden mithilfe der Common Expression Language (CEL) definiert. Weitere Informationen zum Erstellen von Bedingungen in benutzerdefinierten Einschränkungen mit CEL finden Sie im Abschnitt CEL unter Benutzerdefinierte Einschränkungen erstellen und verwalten.

Erstellen Sie eine YAML-Datei im folgenden Format, um eine benutzerdefinierte Einschränkung zu erstellen:

name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resourceTypes:
- RESOURCE_NAME
methodTypes:
- CREATE
- UPDATE
condition: "CONDITION"
actionType: ACTION
displayName: DISPLAY_NAME
description: DESCRIPTION

Ersetzen Sie Folgendes:

• ORGANIZATION_ID: Ihre Organisations-ID, z. B. 123456789.

• CONSTRAINT_NAME: Name, den Sie für Ihre neue benutzerdefinierte Einschränkung verwenden möchten. Eine benutzerdefinierte Einschränkung muss mit custom. beginnen und darf nur Großbuchstaben, Kleinbuchstaben oder Ziffern enthalten. Beispiel: custom.restrictEnvironmentSize. Die maximale Länge dieses Feldes beträgt 70 Zeichen.

• RESOURCE_NAME: Der vollständige Name derGoogle Cloud Ressource, die das Objekt und das Feld enthält, das Sie einschränken möchten. Beispiel: composer.googleapis.com/Environment

• CONDITION: eine CEL-Bedingung, die für eine Darstellung einer unterstützten Dienstressource geschrieben wird. Dieses Feld hat eine maximale Länge von 1000 Zeichen. Weitere Informationen zu den verfügbaren Ressourcen, auf die Bedingungen geschrieben werden können, finden Sie unter Unterstützte Ressourcen. Beispiel: resource.config.environmentSize == "ENVIRONMENT_SIZE_SMALL".

• ACTION: Aktion, die ausgeführt werden soll, wenn condition erfüllt ist. Mögliche Werte sind ALLOW und DENY.

• DISPLAY_NAME: Ein nutzerfreundlicher Name für die Einschränkung. Dieses Feld hat eine maximale Länge von 200 Zeichen.

• DESCRIPTION: Eine nutzerfreundliche Beschreibung der Einschränkung, die als Fehlermeldung angezeigt werden soll, wenn die Richtlinie verletzt wird Dieses Feld hat eine maximale Länge von 2000 Zeichen.

Weitere Informationen zum Erstellen einer benutzerdefinierten Einschränkung finden Sie unter Benutzerdefinierte Einschränkungen definieren.

Benutzerdefinierte Einschränkung einrichten

gcloud org-policies set-custom-constraint CONSTRAINT_PATH

gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID

Benutzerdefinierte Organisationsrichtlinie erzwingen

      name: projects/PROJECT_ID/policies/CONSTRAINT_NAME
      spec:
        rules:
        - enforce: true
    

    gcloud org-policies set-policy POLICY_PATH
    

Benutzerdefinierte Organisationsrichtlinie testen

Im folgenden Beispiel werden eine benutzerdefinierte Einschränkung und eine Richtlinie erstellt, die nur kleine Cloud Composer-Umgebungen zulassen.

Bevor Sie beginnen, sollten Sie Folgendes kennen:

• Ihre Organisations-ID.
• Ihre Projekt-ID

Einschränkung erstellen

1. Speichern Sie die folgende Datei als constraint-require-only-small-environments.yaml:

   name: organizations/ORGANIZATION_ID/customConstraints/custom.restrictEnvironmentSize
   resourceTypes:
   - composer.googleapis.com/Environment
   methodTypes:
   - CREATE
   condition: resource.config.environmentSize == "ENVIRONMENT_SIZE_SMALL"
   actionType: ALLOW
   displayName: Only allow small Composer environments.
   description: All environments must be small.
   

2. Wenden Sie die Einschränkung an:

   gcloud org-policies set-custom-constraint constraint-require-only-small-environments.yaml
   

Richtlinie erstellen

1. Speichern Sie die folgende Datei als policy-require-only-small-environments.yaml:

   name: projects/PROJECT_ID/policies/custom.restrictEnvironmentSize
   spec:
     rules:
     - enforce: true
   

2. Wenden Sie die Richtlinie an:

   
   gcloud org-policies set-policy policy-require-only-small-environments.yaml
   
   

Warten Sie nach dem Anwenden der Richtlinie etwa zwei Minuten, bis Google Clouddie Richtlinie durchgesetzt hat.

Richtlinie testen

gcloud composer environments create ENVIRONMENT_NAME \
  --location=LOCATION \
  --image-version="composer-3-airflow-2.10.2-build.12" \
  --environment-size=medium

Das Erstellen der Umgebung schlägt aufgrund der Einschränkung fehl, dass die Größe der Composer-Umgebung klein sein muss.

Die Ausgabe sieht etwa so aus:

You can't perform this action on a Composer environment due to Custom Organization Policy constraints set on your project. The following constraint(s) were violated: ["customConstraints/custom.restrictEnvironmentSize": All environments must be small.]

Erstellen Sie eine kleine Umgebung, um den vorherigen Fehler zu beheben. Beispiel:

gcloud composer environments create ENVIRONMENT_NAME \
  --location=LOCATION \
  --image-version="composer-3-airflow-2.10.2-build.12" \
  --environment-size=small

Die Erstellung der Umgebung wurde erfolgreich gestartet.

Beispiele für benutzerdefinierte Organisationsrichtlinien für häufige Anwendungsfälle

Die folgende Tabelle enthält die Syntax einiger benutzerdefinierter Einschränkungen für gängige Anwendungsfälle:

      name: organizations/ORGANIZATION_ID/customConstraints/custom.allowOnlyPrivateIp
      resourceTypes:
      - composer.googleapis.com/Environment
      methodTypes:
      - CREATE
      condition: resource.config.privateEnvironmentConfig.enablePrivateEnvironment == true
      actionType: ALLOW
      displayName: Only Private IP environments
      description: All environments must use Private IP networking
    

      name: organizations/ORGANIZATION_ID/customConstraints/custom.restrictMaxWorketCount
      resourceTypes:
      - composer.googleapis.com/Environment
      methodTypes:
      - CREATE
      - UPDATE
      condition: resource.config.workloadsConfig.worker.maxCount <= 10
      actionType: ALLOW
      displayName: Limit the maximum number of workers
      description: All environments must have 10 or less workers
    

Von Cloud Composer unterstützte Ressourcen

Nächste Schritte

• Weitere Informationen zum Organisationsrichtliniendienst
• Organisationsrichtlinien erstellen und verwalten
• Eine vollständige Liste der vordefinierten Einschränkungen für Organisationsrichtlinien finden Sie hier.