このページでは、組織のポリシー サービスのカスタム制約を使用して、次の Google Cloud リソースに対する特定のオペレーションを制限する方法について説明します。
compute.googleapis.com/Interconnect
compute.googleapis.com/InterconnectAttachment
組織のポリシーの詳細については、カスタムの組織のポリシーをご覧ください。
組織のポリシーと制約について
Google Cloud の組織のポリシー サービスを使用すると、組織のリソースをプログラムで一元管理できます。組織のポリシー管理者は組織のポリシーを定義できます。組織のポリシーは、Google Cloud のリソース階層内の Google Cloud リソースやそれらのリソースの子孫に適用される、制約と呼ばれる一連の制限です。組織のポリシーは、組織レベル、フォルダレベル、またはプロジェクト レベルで適用できます。
組織のポリシーは、さまざまな Google Cloud サービスに対して事前に定義された制約を提供します。ただし、組織のポリシーで制限されている特定のフィールドをカスタマイズ可能な方法でよりきめ細かく制御する必要がある場合は、カスタム制約を作成して、組織のポリシーでそれらのカスタム制約を使用することもできます。
ポリシーの継承
デフォルトでは、組織のポリシーは、そのポリシーを適用したリソースの子孫に継承されます。たとえば、フォルダにポリシーを適用した場合、そのフォルダ内のすべてのプロジェクトにそのポリシーが適用されます。この動作の詳細と変更方法については、階層評価ルールをご覧ください。
始める前に
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- 組織 ID を確認します。
必要なロール
組織のポリシーを管理するために必要な権限を取得するには、組織のリソースに対する組織のポリシー管理者(roles/orgpolicy.policyAdmin
)の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
カスタム制約を作成する
カスタム制約は、組織のポリシーを適用しているサービスでサポートされるリソース、メソッド、条件、アクションを使用して YAML ファイルで定義されます。カスタム制約の条件は、Common Expression Language(CEL)を使用して定義されます。CEL を使用してカスタム制約で条件を作成する方法については、カスタム制約の作成と管理の CEL セクションをご覧ください。
カスタム制約を作成するには、次の形式で YAML ファイルを作成します。
name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resourceTypes:
- RESOURCE_NAME
methodTypes:
- CREATE
- UPDATE
condition: "CONDITION"
actionType: ACTION
displayName: DISPLAY_NAME
description: DESCRIPTION
次のように置き換えます。
ORGANIZATION_ID
: 組織 ID(123456789
など)。CONSTRAINT_NAME
: 新しいカスタム制約に付ける名前。カスタム制約はcustom.
で始まる必要があり、大文字、小文字、数字のみを含めることができます(例:custom.restrictNocContactEmailDomain
)。このフィールドの最大長は 70 文字です。RESOURCE_NAME
: 制限するオブジェクトとフィールドを含む Google Cloud リソースの完全修飾名。例:compute.googleapis.com/Interconnect
CONDITION
: サポート対象のサービス リソースの表現に対して書き込まれる CEL 条件。このフィールドの最大長は 1,000 文字です。条件の書き込み先として使用できるリソースの詳細については、サポート対象のリソースをご覧ください。例:"resource.nocContactEmail.endsWith('@example.com')"
ACTION
:condition
が満たされている場合に実行するアクション。有効な値はALLOW
とDENY
です。DISPLAY_NAME
: 制約の名前。わかりやすい名前を入力してください。このフィールドの最大長は 200 文字です。DESCRIPTION
: ポリシー違反時にエラー メッセージとして表示される制約の説明。わかりやすい説明を入力してください。このフィールドの最大長は 2,000 文字です。
カスタム制約の作成方法については、カスタム制約の定義をご覧ください。
カスタム制約を設定する
新しいカスタム制約の YAML ファイルを作成したら、組織内の組織のポリシーで使用できるように設定する必要があります。カスタム制約を設定するには、gcloud org-policies set-custom-constraint
コマンドを使用します。gcloud org-policies set-custom-constraint CONSTRAINT_PATH
CONSTRAINT_PATH
は、カスタム制約ファイルのフルパスに置き換えます。たとえば、/home/user/customconstraint.yaml
になります。完了すると、カスタム制約が組織のポリシーとして Google Cloud 組織のポリシーのリストに表示されます。カスタム制約が存在することを確認するには、gcloud org-policies list-custom-constraints
コマンドを使用します。gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
ORGANIZATION_ID
は、組織リソースの ID に置き換えます。詳細については、組織のポリシーの表示をご覧ください。カスタムの組織のポリシーを適用する
ブール型制約を適用するには、それを参照する組織のポリシーを作成し、Google Cloud リソースに適用します。コンソール
- Google Cloud コンソールで、[組織のポリシー] ページに移動します。
- プロジェクト選択ツールから、組織のポリシーを設定するプロジェクトを選択します。
- [組織のポリシー] ページのリストで制約を選択して、その制約の [ポリシーの詳細] ページを表示します。
- このリソースの組織のポリシーを構成するには、[ポリシーを管理] をクリックします。
- [ポリシーの編集] ページで、[Override parent's policy] を選択します。
- [ルールを追加] をクリックします。
- [適用] セクションで、この組織のポリシーの適用を有効にするかどうかを選択します。
- 省略可: タグで組織のポリシーに条件を設定するには、[条件を追加] をクリックします。組織のポリシーに条件付きルールを追加する場合は、少なくとも 1 つは無条件のルールを追加する必要があります。そうしないとポリシーを保存できないのでご注意ください。詳細については、タグ付きの組織のポリシーの設定をご覧ください。
- カスタム制約の場合は、[変更内容をテスト] をクリックして、組織のポリシーの効果をシミュレートできます。詳細については、Policy Simulator で組織のポリシーの変更をテストするをご覧ください。
- 組織のポリシーを完成させて適用するには、[ポリシーを設定] をクリックします。ポリシーが有効になるまでに最大 15 分かかります。
gcloud
ブール型制約を適用する組織のポリシーを作成するには、制約を参照するポリシー YAML ファイルを作成します。
name: projects/PROJECT_ID/policies/CONSTRAINT_NAME spec: rules: - enforce: true
次のように置き換えます。
-
PROJECT_ID
: 制約を適用するプロジェクト。 -
CONSTRAINT_NAME
: カスタム制約に定義した名前。たとえば、custom.restrictNocContactEmailDomain
のようにします。
制約を含む組織のポリシーを適用するには、次のコマンドを実行します。
gcloud org-policies set-policy POLICY_PATH
POLICY_PATH
は、組織のポリシーの YAML ファイルのパスに置き換えます。ポリシーが有効になるまでに最大 15 分かかります。
カスタム組織のポリシーをテストする
次の例では、特定のプロジェクト内のすべての新しいクラスタが Autopilot クラスタであることを要求するカスタムの制約とポリシーを作成します。
事前に次のものを確認してください。
- 組織の ID
- プロジェクト ID
制約を作成する
次のファイルに
constraint-restrict-noc-contact-email.yaml
という名前を付けて保存します。name: organizations/ORGANIZATION_ID/customConstraints/custom.restrictNocContactEmailDomain resourceTypes: - compute.googleapis.com/Interconnect methodTypes: - CREATE - UPDATE condition: "resource.nocContactEmail.endsWith('@example.com')" actionType: ALLOW displayName: Restrict allowed NOC contact email domains. description: All Interconnects must have NOC contact email set to an address in the example.com domain.
これにより、すべての Cloud Interconnect の NOC 連絡先メールアドレスが指定のドメインに存在する必要があるという制約が定義されます。
制約を適用します。
gcloud org-policies set-custom-constraint ~/constraint-restrict-noc-contact-email.yaml
制約が存在することを確認します。
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
出力は次のようになります。
CUSTOM_CONSTRAINT ACTION_TYPE METHOD_TYPES RESOURCE_TYPES DISPLAY_NAME custom.restrictNocContactEmailDomain ALLOW CREATE,UPDATE compute.googleapis.com/Interconnect Restrict allowed NOC contact email domains. ...
ポリシーを作成する
次のファイルに
policy-restrict-noc-contact-email.yaml
という名前を付けて保存します。name: projects/PROJECT_ID/policies/custom.enableGkeAutopilot spec: rules: - enforce: true
PROJECT_ID
は、実際のプロジェクト ID に置き換えます。ポリシーを適用します。
gcloud org-policies set-policy ~/policy-restrict-noc-contact-email.yaml
ポリシーが存在することを確認します。
gcloud org-policies list --project=PROJECT_ID
出力は次のようになります。
CONSTRAINT LIST_POLICY BOOLEAN_POLICY ETAG custom.restrictNocContactEmailDomain - SET COCsm5QGENiXi2E=
ポリシーを適用してから Google Cloud でポリシーの適用が開始されるまで 2 分ほど待ちます。
ポリシーをテストする
gcloud compute interconnects create demo-interconnect \
--customer-name=example_customer \
--interconnect-type=DEDICATED \
--link-type=LINK_TYPE_ETHERNET_10G_LR \
--location=example_location \
--requested-link-count=1 \
--noc-contact-email="noc@wrong.domain"
出力は次のようになります。
Operation denied by custom org policies: ["customConstraints/custom.restrictNocContactEmailDomain": "All Interconnects must have NOC contact email set to an address in the example.com domain."]
一般的なユースケースのカスタム組織ポリシーの例
次の表に、一般的なユースケースのカスタム制約の構文を示します。
説明 | 制約の構文 |
---|---|
NOC の連絡先メールアドレスをドメイン内のアドレスに制限する |
name: organizations/ORGANIZATION_ID/customConstraints/custom.enableRestrictNocContactEmailDomain resourceTypes: - compute.googleapis.com/Interconnect methodTypes: - CREATE - UPDATE condition: "resource.nocContactEmail.endsWith('@example.com')" actionType: ALLOW displayName: Restrict allowed NOC contact email domains. description: All Interconnects must have NOC contact email set to an address in the example.com domain. |
すべての相互接続のアタッチメントで暗号化を必須にする |
name: organizations/ORGANIZATION_ID/customConstraints/custom.enableRequireEncryption resourceTypes: - compute.googleapis.com/InterconnectAttachment methodTypes: - CREATE - UPDATE condition: "has(resource.encryption) && resource.encryption == 'IPSEC'" actionType: ALLOW displayName: Require encryption for all interconnect attachments. description: All interconnect attachments must use IPSEC encryption option. |
Cloud Interconnect でサポートされているリソースとオペレーション
次の表に、カスタム制約で参照可能な Cloud Interconnect リソースを示します。リソース | フィールド |
---|---|
compute.googleapis.com/Interconnect |
resource.adminEnabled
|
resource.customerName
| |
resource.description
| |
resource.interconnectType
| |
resource.linkType
| |
resource.location
| |
resource.macsec.failOpen
| |
resource.macsec.preSharedKeys.name
| |
resource.macsec.preSharedKeys.startTime
| |
resource.macsecEnabled
| |
resource.name
| |
resource.nocContactEmail
| |
resource.remoteLocation
| |
resource.requestedFeatures
| |
resource.requestedLinkCount
| |
compute.googleapis.com/InterconnectAttachment |
resource.adminEnabled
|
resource.bandwidth
| |
resource.candidateSubnets
| |
resource.description
| |
resource.edgeAvailabilityDomain
| |
resource.encryption
| |
resource.ipsecInternalAddresses
| |
resource.mtu
| |
resource.name
| |
resource.router
| |
resource.stackType
| |
resource.subnetLength
| |
resource.type
| |
resource.vlanTag8021q
|
次のステップ
- Cloud Interconnect オプションについて確認する。Cloud Interconnect の概要をご覧ください。
- Cloud Interconnect の使用時に発生する可能性のある一般的な問題を解決する。トラブルシューティングをご覧ください。
- 事前定義された Cloud Interconnect の組織のポリシーの制約を確認する。
- 組織ポリシー サービスの詳細を学習する。
- 組織のポリシーの作成と管理の方法について学習する。
- 事前定義された組織のポリシーの制約の完全なリストを確認する。