Mit dem Policy Simulator für Organisationsrichtlinien können Sie sich eine Vorschau der Auswirkungen einer neuen benutzerdefinierten Einschränkung oder Organisationsrichtlinie ansehen, die eine benutzerdefinierte oder verwaltete Einschränkung erzwingt, bevor sie in Ihrer Produktionsumgebung erzwungen wird. Der Policy Simulator stellt eine Liste der Ressourcen bereit, die gegen die vorgeschlagene Richtlinie verstoßen, bevor sie erzwungen wird. So können Sie diese Ressourcen neu konfigurieren, Ausnahmen anfordern oder den Bereich Ihrer Organisationsrichtlinie ändern, ohne Ihre Entwickler zu stören oder Ihre Umgebung zu beeinträchtigen.
Auf dieser Seite wird beschrieben, wie Sie eine Änderung an einer Organisationsrichtlinie mit dem Policy Simulator testen. Außerdem werden die Ergebnisse der Simulation und die Anwendung der getesteten Organisationsrichtlinie auf Anfrage erläutert.
Hinweis
-
Wenn Sie die Google Cloud CLI verwenden, legen Sie das Projekt fest, das Sie für API-Aufrufe verwenden möchten:
gcloud config set project PROJECT_IDErsetzen Sie
PROJECT_IDdurch den Namen oder die ID des Projekts. -
Aktivieren Sie die Policy Simulator API und die Resource Manager API, falls sie noch nicht aktiviert sind.
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die Berechtigung
serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen - Optional: Einführung in den Organisationsrichtliniendienst
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle OrgPolicy Simulator Admin (roles/policysimulator.orgPolicyAdmin) für die Organisation zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Ausführen von Simulationen und zum Zugriff darauf benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Ausführen von Simulationen und zum Zugriff darauf erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um Simulationen auszuführen und darauf zuzugreifen:
-
orgpolicy.constraints.list -
orgpolicy.customConstraints.get -
orgpolicy.policies.list -
cloudasset.assets.searchAllResources -
cloudasset.assets.listResource -
cloudasset.assets.listOrgPolicy -
policysimulator.orgPolicyViolationsPreviews.list -
policysimulator.orgPolicyViolationsPreviews.get -
policysimulator.orgPolicyViolationsPreviews.create -
policysimulator.orgPolicyViolations.list
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Richtlinienänderung testen
Sie können eine Änderung an einer benutzerdefinierten Einschränkung, einer Organisationsrichtlinie, die eine benutzerdefinierte oder verwaltete Einschränkung erzwingt, oder beides gleichzeitig testen.
Änderung an einer benutzerdefinierten Einschränkung testen
Console
Wechseln Sie in der Google Cloud Console zur Seite Organisationsrichtlinien.
Wählen Sie in der Organisationsauswahl Ihre Organisationsressource aus.
Führen Sie einen der folgenden Schritte aus:
Klicken Sie auf Benutzerdefinierte Einschränkung, um eine neue benutzerdefinierte Einschränkung zu testen.
Wenn Sie Änderungen an einer vorhandenen benutzerdefinierten Einschränkung vornehmen möchten, wählen Sie sie auf der Seite Organisationsrichtlinien aus der Liste aus und klicken Sie dann auf Einschränkung bearbeiten.
Erstellen oder aktualisieren Sie die benutzerdefinierte Einschränkung, die Sie testen möchten.
Geben Sie im Feld Anzeigename einen nutzerfreundlichen Namen für die Einschränkung ein. Dieses Feld hat eine maximale Länge von 200 Zeichen. Verwenden Sie keine personenidentifizierbaren Informationen oder vertraulichen Daten in Anzeigenamen, da diese in Fehlermeldungen angezeigt werden können.
Geben Sie im Feld Einschränkungs-ID den gewünschten Namen für die neue benutzerdefinierte Einschränkung ein. Eine benutzerdefinierte Einschränkung muss mit
custom.beginnen und darf nur Großbuchstaben, Kleinbuchstaben oder Ziffern enthalten, z. B.custom.disableGkeAutoUpgrade. Die maximale Länge dieses Feldes beträgt 70 Zeichen, das Präfix wird nicht gezählt (z. B.organizations/123456789/customConstraints/custom.). Beziehen Sie weder personenidentifizierbare Informationen noch sensible Daten in die ID der Einschränkung ein, da sie in Fehlermeldungen preisgegeben werden könnten.Die Einschränkungs-ID kann nach dem Erstellen einer benutzerdefinierten Einschränkung nicht mehr geändert werden.
Geben Sie im Feld Beschreibung eine nutzerfreundliche Beschreibung der Einschränkung ein, die bei einer Verletzung der Richtlinie als Fehlermeldung angezeigt wird. Dieses Feld hat eine maximale Länge von 2000 Zeichen. Beziehen Sie weder personenidentifizierbare Informationen noch sensible Daten in die Beschreibung ein, da sie in Fehlermeldungen preisgegeben werden könnten.
Wählen Sie im Feld Ressourcentyp den Namen der REST-Ressource von Google Cloudaus, die das Objekt und das Feld enthält, das Sie einschränken möchten, zum Beispiel
container.googleapis.com/NodePool. Für die meisten Ressourcentypen können maximal 20 benutzerdefinierte Einschränkungen pro Ressource festgelegt werden. Wenn Sie versuchen, eine benutzerdefinierte Einschränkung für eine Ressource zu erstellen, die bereits die maximale Anzahl von benutzerdefinierten Einschränkungen hat, schlägt der Vorgang fehl.Wählen Sie im Abschnitt Methode erzwingen aus, ob die Einschränkung für eine REST-Methode
CREATEoder sowohl für die MethodenCREATEals auchUPDATEerzwungen werden soll. Nicht alle Google Cloud -Dienste unterstützen beide Methoden. Die unterstützten Methoden für die einzelnen Dienste finden Sie unter Unterstützte Dienste.Klicken Sie zum Definieren einer Bedingung auf Bedingung bearbeiten.
Erstellen Sie im Bereich Bedingung hinzufügen eine CEL-Bedingung, die auf eine unterstützte Dienstressource verweist, z. B.
resource.management.autoUpgrade == false. Dieses Feld hat eine maximale Länge von 1.500 Zeichen. Weitere Informationen zur Verwendung von CEL finden Sie unter Common Expression Language. Weitere Informationen zu den Dienstressourcen, die Sie in Ihren benutzerdefinierten Einschränkungen verwenden können, finden Sie unter Unterstützte Dienste für benutzerdefinierte Einschränkungen.Klicken Sie auf Speichern.
Wählen Sie im Abschnitt Aktion aus, ob die ausgewertete Methode zugelassen oder abgelehnt werden soll, wenn die von Ihnen geschriebene Bedingung erfüllt ist.
Die Ablehnungsaktion bedeutet, dass der Vorgang zum Erstellen oder Aktualisieren der Ressource blockiert wird, wenn die Bedingung als wahr ausgewertet wird.
Die Aktion „Zulassen“ bedeutet, dass der Vorgang zum Erstellen oder Aktualisieren der Ressource nur zulässig ist, wenn die Bedingung als wahr ausgewertet wird. Alle anderen Fälle, mit Ausnahme der explizit in der Bedingung aufgeführten, werden blockiert.
Klicken Sie auf Einschränkung testen.
Wenn es sich um eine neue Einschränkung handelt, wird der Bereich Organisationsrichtlinie konfigurieren angezeigt. So definieren Sie eine Organisationsrichtlinie, die die benutzerdefinierte Einschränkung erzwingt:
Wählen Sie im Feld Bereich auswählen die Ressource aus, für die Sie die benutzerdefinierte Einschränkung testen möchten.
Klicken Sie auf Richtlinie der übergeordneten Ressource überschreiben.
Klicken Sie auf Regel hinzufügen.
Wählen Sie im Abschnitt Erzwingung die Option An aus.
Klicken Sie optional auf Bedingung hinzufügen, um die Organisationsrichtlinie von einem Tag abhängig zu machen. Wenn Sie einer Organisationsrichtlinie eine bedingte Regel hinzufügen, müssen Sie mindestens eine bedingungsfreie Regel hinzufügen, da die Richtlinie sonst nicht gespeichert werden kann. Weitere Informationen finden Sie unter Organisationsrichtlinie mit Tags festlegen.
Klicken Sie auf Fertig und dann auf Weiter.
Die Seite Simulationsverlauf wird angezeigt. Sie enthält eine Liste der Simulationen, die Sie in den letzten 14 Tagen ausgeführt haben. Weitere Informationen finden Sie auf dieser Seite unter Ergebnisse des Richtliniensimulators.
gcloud
Wenn Sie die Erzwingung einer neuen oder aktualisierten benutzerdefinierten Einschränkung testen möchten, erstellen Sie eine JSON- oder YAML-Datei, in der die benutzerdefinierte Einschränkung definiert ist, die Sie testen möchten.
Wenn Sie Änderungen an einer vorhandenen benutzerdefinierten Einschränkung testen möchten, können Sie mit dem gcloud CLI-Befehl
organizations.customConstraints.getdie aktuelle JSON- oder YAML-Darstellung der benutzerdefinierten Einschränkung abrufen und dann Änderungen an dieser Datei vornehmen.Eine YAML-Datei, die eine benutzerdefinierte Einschränkung definiert, sieht in etwa so aus:
name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME resourceTypes: - RESOURCE_NAME methodTypes: - METHOD1 - METHOD2 condition: "CONDITION" actionType: ACTION displayName: DISPLAY_NAME description: DESCRIPTIONErsetzen 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 mitcustom.beginnen und darf nur Großbuchstaben, Kleinbuchstaben oder Ziffern enthalten, z. B.custom.disableGkeAutoUpgrade. Die maximale Länge dieses Feldes beträgt 70 Zeichen, das Präfix wird nicht gezählt (z. B.organizations/123456789/customConstraints/custom.).RESOURCE_NAME: Der vollständig qualifizierte Name der REST-Ressource vonGoogle Cloud , die das Objekt und das Feld enthält, das Sie beschränken möchten. Beispiel:container.googleapis.com/NodePoolDie meisten Ressourcentypen können maximal 20 benutzerdefinierte Einschränkungen pro Ressource haben. Wenn Sie versuchen, eine benutzerdefinierte Einschränkung für eine Ressource zu erstellen, die bereits die maximale Anzahl von benutzerdefinierten Einschränkungen hat, schlägt der Vorgang fehl. Weitere Informationen zu den Dienstressourcen, die Sie in Ihren benutzerdefinierten Einschränkungen verwenden können, finden Sie unter Unterstützte Dienste für benutzerdefinierte Einschränkungen.METHOD1,METHOD2: Liste der RESTful-Methoden, für die die Einschränkung erzwungen werden soll. KannCREATEoderCREATEundUPDATEsein. Nicht alle Google Cloud -Dienste unterstützen beide Methoden. Die unterstützten Methoden für die einzelnen Dienste finden Sie unter Unterstützte Dienste.CONDITION: eine CEL-Bedingung, die auf eine unterstützte Dienstressource verweist, z. B."resource.management.autoUpgrade == false". Dieses Feld hat eine maximale Länge von 1.500 Zeichen. Weitere Informationen zur Verwendung von CEL finden Sie unter Common Expression Language.ACTION: Aktion, die ausgeführt werden soll, wennconditionerfüllt ist. Dies kann entwederALLOWoderDENYsein.Die Ablehnungsaktion bedeutet, dass der Vorgang zum Erstellen oder Aktualisieren der Ressource blockiert wird, wenn die Bedingung als wahr ausgewertet wird.
Die Aktion „Zulassen“ bedeutet, dass der Vorgang zum Erstellen oder Aktualisieren der Ressource zulässig ist, wenn die Bedingung als wahr ausgewertet wird. Das bedeutet auch, dass alle anderen Fälle außer dem explizit in der Bedingung aufgeführten blockiert werden.
DISPLAY_NAME: Ein nutzerfreundlicher Name für die Beschränkung. Dieses Feld hat eine maximale Länge von 200 Zeichen.DESCRIPTION: Eine nutzerfreundliche Beschreibung der Beschränkung, die als Fehlermeldung angezeigt werden soll, wenn die Richtlinie verletzt wird. Dieses Feld hat eine maximale Länge von 2.000 Zeichen. Weitere Informationen zum Erstellen benutzerdefinierter Einschränkungen finden Sie unter Benutzerdefinierte Einschränkungen erstellen und verwalten.
Erstellen oder ändern Sie eine Organisationsrichtlinie, die die benutzerdefinierte Einschränkung erzwingt.
Wenn Sie die Erzwingung einer neuen oder aktualisierten benutzerdefinierten Einschränkung testen möchten, erstellen Sie eine JSON- oder YAML-Datei, in der die zu testende Organisationsrichtlinie definiert ist:
name: organizations/ORGANIZATION_ID/policies/CONSTRAINT_NAME spec: rules: - enforce: trueErsetzen Sie Folgendes:
ORGANIZATION_IDdurch Ihre Organisations-ID, z. B.1234567890123.CONSTRAINT_NAMEdurch den Namen der benutzerdefinierten Einschränkung, die Sie testen möchten. Beispiel:custom.EnforceGKEBinaryAuthz
Wenn Sie die bedingte Erzwingung einer benutzerdefinierten Einschränkung basierend auf dem Vorhandensein eines bestimmten Tags testen möchten, erstellen Sie eine JSON- oder YAML-Datei, die die Organisationsrichtlinie definiert:
name: organizations/ORGANIZATION_ID/policies/CONSTRAINT_NAME spec: rules: - condition: expression: CONDITION enforce: false - enforce: trueErsetzen Sie Folgendes:
ORGANIZATION_IDdurch Ihre Organisations-ID, z. B.1234567890123.CONSTRAINT_NAMEdurch den Namen der benutzerdefinierten Einschränkung, die Sie testen möchten. Beispiel:custom.EnforceGKEBinaryAuthzCONDITIONdurch eine CEL-Bedingung, die auf eine unterstützte Dienstressource verweist, z. B."resource.matchTag('env', 'dev')".
Weitere Informationen zu bedingten Organisationsrichtlinien finden Sie unter Organisationsrichtlinie mit Tags festlegen.
Wenn Sie das Löschen einer Organisationsrichtlinie testen möchten, die eine benutzerdefinierte Einschränkung erzwingt, erstellen Sie eine JSON- oder YAML-Datei, in der die Organisationsrichtlinie ohne Regelsatz definiert ist, mit Ausnahme der Übernahme der Richtlinie von der übergeordneten Ressource:
name: organizations/ORGANIZATION_ID/policies/CONSTRAINT_NAME spec: inheritFromParent: trueErsetzen Sie Folgendes:
ORGANIZATION_IDdurch Ihre Organisations-ID, z. B.1234567890123.CONSTRAINT_NAMEdurch den Namen der benutzerdefinierten Einschränkung, die Sie testen möchten. Beispiel:custom.EnforceGKEBinaryAuthz
Führen Sie den Befehl
policy-intelligence simulate orgpolicyaus, um die Änderung an einer benutzerdefinierten Einschränkung, einer Organisationsrichtlinie oder beidem zu simulieren:gcloud policy-intelligence simulate orgpolicy \ --organization=ORGANIZATION_ID \ --custom-constraints=CONSTRAINT_PATH \ --policies=POLICY_PATHErsetzen Sie Folgendes:
ORGANIZATION_ID: Ihre Organisations-ID, z. B.1234567890123. Das Simulieren von Änderungen über mehrere Organisationen hinweg wird nicht unterstützt.CONSTRAINT_PATH: der vollständige Pfad zur benutzerdefinierten Einschränkung, die Sie erstellt oder aktualisiert haben. Beispiel:tmp/constraint.yamlWenn Sie das Flag--policiesfestlegen, müssen Sie das Flag--custom-constraintsnicht festlegen.POLICY_PATH: der vollständige Pfad zur Organisationsrichtlinie, die Sie erstellt oder aktualisiert haben. Beispiel:tmp/policy.yamlWenn Sie das Flag--custom-constraintsfestlegen, müssen Sie das Flag--policiesnicht festlegen.
Nach einigen Minuten gibt der Befehl eine Liste mit Ressourcen aus, die gegen die Änderungen an der benutzerdefinierten Einschränkung, der Organisationsrichtlinie oder beidem verstoßen würden.
Die Ergebnisse können auch auf der Seite Simulationsverlauf der Google Cloud Console aufgerufen werden. Weitere Informationen zum Lesen der Ergebnisse finden Sie unter Ergebnisse des Richtliniensimulators auf dieser Seite.
Das folgende Beispiel zeigt eine Antwort für eine Simulation einer Organisationsrichtlinie.
Diese Simulation umfasst eine benutzerdefinierte Einschränkung, die die Erstellung von Google Kubernetes Engine-Clusterressourcen einschränkt, wenn die Binärautorisierung nicht aktiviert ist. Wenn in diesem Fall die vorgeschlagene Änderung angewendet wird, verstoßen zwei Clusterressourcen gegen die Richtlinie: orgpolicy-test-cluster im Projekt simulator-test-project und autopilot-cluster-1 im Projekt orgpolicy-test-0.
Waiting for operation [organizations/012345678901/locations/global/orgPolic
yViolationsPreviews/85be9a2d-8c49-470d-a65a-d0cb9ffa8f83/operations/1883a83
c-c448-42e5-a7c5-10a850928f06] to complete...done.
---
customConstraint:
actionType: ALLOW
condition: resource.binaryAuthorization.enabled == true
methodTypes:
- CREATE
name: organizations/012345678901/customConstraints/custom.EnforceGKEBinaryAuthz
resourceTypes:
- container.googleapis.com/Cluster
name: organizations/012345678901/locations/global/orgPolicyViolationsPreviews/3dd47fd3-6df1-4156-8f10-413a3fc0ed83/orgPolicyViolations/b9fd23a5-7163-46de-9fec-7b9aa6af1113
resource:
ancestors:
- organizations/012345678901
- projects/456789012345
assetType: container.googleapis.com/Cluster
resource: //container.googleapis.com/projects/simulator-test-project/locations/us-central1/clusters/orgpolicy-test-cluster
---
customConstraint:
actionType: ALLOW
condition: resource.binaryAuthorization.enabled == true
methodTypes:
- CREATE
name: organizations/012345678901/customConstraints/custom.EnforceGKEBinaryAuthz
resourceTypes:
- container.googleapis.com/Cluster
name: organizations/012345678901/locations/global/orgPolicyViolationsPreviews/3dd47fd3-6df1-4156-8f10-413a3fc0ed83/orgPolicyViolations/e73896e6-7613-4a8d-8436-5df7a6455121
resource:
ancestors:
- organizations/012345678901
- folders/789012345678
- projects/456789012345
assetType: container.googleapis.com/Cluster
resource: //container.googleapis.com/projects/orgpolicy-test-0/locations/us-central1/clusters/autopilot-cluster-1
Änderung an einer verwalteten Einschränkung testen
Console
Wechseln Sie in der Google Cloud Console zur Seite Organisationsrichtlinien.
Klicken Sie auf Projekt auswählen und wählen Sie dann die Organisation, den Ordner oder die Projektressource aus, für die Sie die Organisationsrichtlinie bearbeiten möchten.
Wählen Sie aus der Liste die verwaltete Einschränkung aus, für die Sie die Organisationsrichtlinie aktualisieren möchten. Auf der Seite Richtliniendetails sehen Sie die Quelle dieser Organisationsrichtlinie, die effektive Richtlinienbewertung für diese Ressource und weitere Details zur verwalteten Einschränkung.
Zum Konfigurieren der Organisationsrichtlinie für diese Ressource klicken Sie auf Richtlinie verwalten.
Wählen Sie auf der Seite Richtlinie bearbeiten die Option Richtlinie der übergeordneten Ressource überschreiben aus.
Klicken Sie auf Regel hinzufügen.
Wählen Sie im Abschnitt Erzwingung aus, ob die Erzwingung dieser Organisationsrichtlinie aktiviert oder deaktiviert werden soll.
Klicken Sie optional auf Bedingung hinzufügen, um die Organisationsrichtlinie von einem Tag abhängig zu machen. Wenn Sie einer Organisationsrichtlinie eine bedingte Regel hinzufügen, müssen Sie mindestens eine bedingungsfreie Regel hinzufügen, da die Richtlinie sonst nicht gespeichert werden kann. Weitere Informationen finden Sie unter Organisationsrichtlinie mit Tags festlegen.
Klicken Sie auf Änderungen testen.
Die Seite Simulationsverlauf wird angezeigt. Sie enthält eine Liste der Simulationen, die Sie in den letzten 14 Tagen ausgeführt haben. Weitere Informationen finden Sie auf dieser Seite unter Ergebnisse des Richtliniensimulators.
gcloud
Erstellen oder ändern Sie eine Organisationsrichtlinie, die eine verwaltete Einschränkung erzwingt.
Wenn Sie das Erstellen oder Aktualisieren einer Organisationsrichtlinie testen möchten, die eine verwaltete Einschränkung erzwingt, erstellen Sie eine JSON- oder YAML-Datei, in der die Organisationsrichtlinie definiert ist.
name: RESOURCE_TYPE/RESOURCE_ID/policies/CONSTRAINT_NAME spec: rules: - enforce: ENFORCEMENT_STATEErsetzen Sie Folgendes:
RESOURCE_TYPEdurchorganizations,foldersoderprojects.RESOURCE_IDdurch Ihre Organisations-ID, Ordner-ID, Projekt-ID oder Projektnummer, je nach dem inRESOURCE_TYPEangegebenen Ressourcentyp.CONSTRAINT_NAMEdurch den Namen der verwalteten Einschränkung, die Sie testen möchten. Beispiel:iam.managed.disableServiceAccountKeyCreationENFORCEMENT_STATEdurchtrue, um diese Organisationsrichtlinie zu erzwingen, wenn sie festgelegt ist, oder durchfalse, um sie zu deaktivieren, wenn sie festgelegt ist.
Optional können Sie einen
condition-Block zumruleshinzufügen, um die Organisationsrichtlinie von einem Tag abhängig zu machen. Wenn Sie einer Organisationsrichtlinie eine bedingte Regel hinzufügen, müssen Sie mindestens eine bedingungsfreie Regel hinzufügen, da die Richtlinie sonst nicht gespeichert werden kann. Weitere Informationen finden Sie unter Organisationsrichtlinie mit Tags festlegen.Wenn Sie das Löschen einer Organisationsrichtlinie testen möchten, die eine verwaltete Einschränkung erzwingt, erstellen Sie eine JSON- oder YAML-Datei, in der die Organisationsrichtlinie ohne Regelsatz definiert ist, mit Ausnahme der Übernahme der Richtlinie von der übergeordneten Ressource:
name: organizations/ORGANIZATION_ID/policies/CONSTRAINT_NAME spec: inheritFromParent: true
Ersetzen Sie Folgendes:
ORGANIZATION_IDdurch Ihre Organisations-ID.CONSTRAINT_NAMEdurch den Namen der verwalteten Einschränkung, die Sie löschen möchten. Beispiel:iam.managed.disableServiceAccountKeyCreation
Führen Sie den Befehl
policy-intelligence simulate orgpolicyaus:gcloud policy-intelligence simulate orgpolicy \ --organization=ORGANIZATION_ID \ --policies=POLICY_PATHErsetzen Sie Folgendes:
ORGANIZATION_IDdurch Ihre Organisations-ID, z. B.1234567890123. Das Simulieren von Änderungen über mehrere Organisationen hinweg wird nicht unterstützt.POLICY_PATHdurch den vollständigen Pfad zur YAML-Datei Ihrer Organisationsrichtlinie.
Nach einigen Minuten gibt der Befehl eine Liste mit Ressourcen aus, die gegen die Änderungen an der benutzerdefinierten Einschränkung, der Organisationsrichtlinie oder beidem verstoßen würden.
Die Ergebnisse können auch auf der Seite Simulationsverlauf der Google Cloud Console aufgerufen werden. Weitere Informationen zum Lesen der Ergebnisse finden Sie unter Ergebnisse des Richtliniensimulators auf dieser Seite.
Ergebnisse des Policy Simulator
Der Policy Simulator meldet die Ergebnisse einer Änderung einer benutzerdefinierten Einschränkung oder Organisationsrichtlinie als Liste von Verstößen gegen die simulierte Richtlinie. In derGoogle Cloud -Konsole werden die Ergebnisse der Simulationen gespeichert, die Sie in den letzten 14 Tagen generiert haben.
Wenn Sie sich die Simulationsergebnisse ansehen möchten, rufen Sie die Seite Simulationsverlauf auf.
Für jede Simulation werden auf der Seite die Organisationsrichtlinie, für die die Simulation gilt, das Datum, an dem Sie die Simulation gestartet haben, und der Status der Simulation aufgeführt.
Simulationen können die folgenden Status haben:
- In Bearbeitung: Die Simulation wird ausgeführt, ist aber noch nicht abgeschlossen. Sie können bis zu 50 laufende Simulationen haben.
- Abgeschlossen: Die Simulation ist abgeschlossen.
- Fehler: Die Simulation konnte aufgrund eines Fehlers nicht abgeschlossen werden.
Wählen Sie eine Simulation aus, um Details anzusehen. Auf der Seite Simulationsbericht sehen Sie eine Vorschau der Verstöße. Dort finden Sie die Gesamtzahl der Verstöße, die durch die neue benutzerdefinierte Einschränkung oder Organisationsrichtlinie verursacht wurden, die Anzahl der Ressourcen, die im Rahmen der Simulation geprüft wurden, und die Zeit, zu der die Simulation abgeschlossen wurde.
Wenn Sie eine benutzerdefinierte Einschränkung simuliert haben, können Sie auf Einschränkungsdetails klicken, um die spezifische Konfiguration aufzurufen, die simuliert wurde. Wenn Sie eine Organisationsrichtlinie simuliert haben, wird auf dem Tab Richtliniendetails die simulierte Konfiguration angezeigt.
Alle Verstöße werden in der Ressourcentabelle aufgeführt. Jede Ressource, die gegen die neue benutzerdefinierte Einschränkung oder Organisationsrichtlinie verstößt, wird mit einem Link zum Ressourceneintrag in Cloud Asset Inventory aufgeführt. Projekt-, Ordner- und Organisationsressourcen werden mit der Gesamtzahl der Ressourcen angezeigt, die sich in der Hierarchie unter ihnen befinden und gegen die neue benutzerdefinierte Einschränkung oder Organisationsrichtlinie verstoßen.
Getestete Richtlinienänderung anwenden
Nachdem Sie die benutzerdefinierte Einschränkung, die Organisationsrichtlinie oder beides getestet haben, können Sie die benutzerdefinierte Einschränkung einrichten und die Organisationsrichtlinie erzwingen. Sie können alle Ergebnisse des Policy Simulator in der Google Cloud Console sehen, unabhängig davon, wie sie generiert wurden. Wenn Ihr Simulationsbericht Änderungen an maximal einer Organisationsrichtlinie enthält, können Sie die Organisationsrichtlinie direkt über die Simulationsergebnisse erzwingen. Verwenden Sie die Google Cloud CLI, um Teständerungen in mehreren Organisationsrichtlinien zu erzwingen.
Console
Wenn Sie die Ergebnisse des Policy Simulator für eine benutzerdefinierte Einschränkung erzwingen möchten, rufen Sie die Seite Simulationsverlauf auf.
Wählen Sie den Simulationsbericht für die benutzerdefinierte Einschränkung oder Organisationsrichtlinie aus, die Sie anwenden möchten.
Wenn dieser Simulationsbericht eine benutzerdefinierte Einschränkung enthält, klicken Sie auf Einschränkung speichern.
Wenn dieser Simulationsbericht Änderungen an maximal einer Organisationsrichtlinie enthält, können Sie diese Organisationsrichtlinie als Probelaufrichtlinie anwenden, um das Verhalten in der Produktion ohne Risiken zu überwachen. Klicken Sie dazu auf Probelaufrichtlinie festlegen. Die Seite Richtliniendetails für die neue Organisationsrichtlinie wird angezeigt.
Sie können die Organisationsrichtlinie sofort erzwingen, indem Sie auf und dann auf Richtlinie festlegen klicken.
gcloud
Wenn Sie eine benutzerdefinierte Einschränkung erzwingen möchten, müssen Sie sie so einrichten, dass sie für Organisationsrichtlinien in Ihrer Organisation verfügbar ist. Verwenden Sie zum Einrichten einer benutzerdefinierten Beschränkung den Befehl gcloud org-policies set-custom-constraint:
gcloud org-policies set-custom-constraint CONSTRAINT_PATHErsetzen Sie
CONSTRAINT_PATHdurch den vollständigen Pfad zu Ihrer benutzerdefinierten Einschränkungsdatei. Beispiel:/home/user/customconstraint.yaml.Anschließend ist Ihre benutzerdefinierte Einschränkung in der Liste der Organisationsrichtlinien von Google Cloud verfügbar.
Verwenden Sie zum Festlegen der Organisationsrichtlinie den Befehl gcloud org-policies set-policy:
gcloud org-policies set-policy POLICY_PATHErsetzen Sie
POLICY_PATHdurch den vollständigen Pfad zur YAML-Datei Ihrer Organisationsrichtlinie.Es kann bis zu 15 Minuten dauern, bis die Richtlinie wirksam wird.
Simulationsergebnisse speichern
Console
Wenn Sie die Google Cloud Console verwenden, können Sie die Policy Simulator-Ergebnisse als CSV-Datei speichern.
Wenn Sie die Ergebnisse des Policy Simulator speichern möchten, rufen Sie die Seite Simulationsverlauf auf.
Wählen Sie den Simulationsbericht aus, den Sie speichern möchten.
Klicken Sie auf Vollständige Ergebnisse exportieren.
gcloud
Wenn Sie die gcloud CLI verwenden, können Sie die Policy Simulator-Ergebnisse als JSON- oder YAML-Datei speichern.
Standardmäßig werden Testergebnisse in der Google Cloud CLI im YAML-Format ausgegeben. Wenn Sie ein Testergebnis als YAML-Datei speichern möchten, leiten Sie die Ausgabe des Befehls simulate orgpolicy beim Ausführen der Simulation um:
> FILENAMEErsetzen Sie FILENAME durch einen Namen für die Ausgabedatei.
Um ein Testergebnis als JSON-Datei zu speichern, fügen Sie dem Befehl simulate orgpolicy beim Ausführen der Simulation das folgende Flag hinzu:
--format=json > FILENAME
Ersetzen Sie FILENAME durch einen Namen für die Ausgabedatei.
Fehler
Die folgenden Fehler können dazu führen, dass eine Simulation fehlschlägt:
- Maximale Anzahl gleichzeitiger Simulationen überschritten: Der Nutzer hat bereits 50 laufende Simulationen. Das ist die maximale Anzahl laufender Simulationen, die ein Nutzer haben kann. Warten Sie, bis eine der laufenden Simulationen abgeschlossen ist, und versuchen Sie dann, die Simulation noch einmal auszuführen.
- Zeitüberschreitung: Die Ausführung der Simulation hat zu lange gedauert und es ist eine Zeitüberschreitung aufgetreten. Bei Simulationen, die länger als 4 Stunden dauern, wird automatisch ein Zeitlimit überschritten. Führen Sie die Simulation noch einmal aus oder reduzieren Sie die Größe der Simulation, um das Problem zu beheben.
- Ungültige Simulationskonstruktion: Die vorgeschlagene Organisationsrichtlinie ist ungültig. Beispiel: Die vorgeschlagene Richtlinie enthält einen ungültigen Bedingungsausdruck. Korrigieren Sie die Richtlinie und versuchen Sie es noch einmal.
- Berechtigung verweigert: Sie sind nicht berechtigt, eine Simulation auszuführen. Prüfen Sie zur Behebung des Problems, ob Ihnen die erforderlichen Rollen zugewiesen sind, und versuchen Sie es noch einmal.