このドキュメントでは、Resource Manager の管理境界と機能構成について説明します。管理境界は、複数の Google Cloud プロジェクトにわたって動的なタグベースの管理境界を確立し、指定された管理プロジェクトから一元化されたガバナンスと検出を可能にします。
管理境界とハブ アンド スポーク モデル
Resource Manager は、静的なフォルダ階層の包含に加えて、動的なタグでパーティション化されたハブアンドスポーク管理モデルをサポートしています。
- 管理プロジェクト（ハブ）:
CapabilityConfigで有効になっているサービスのコントロール プレーン、Management API、メタデータ、プロジェクト間のビューをホストする一元化された Google Cloud プロジェクト。 - メンバー プロジェクト（スポーク）: ワークロード、サービス、リソースを含むフォルダまたは組織全体の Google Cloud プロジェクト。一致するリソースタグを適用すると、プロジェクトは境界に動的に参加します。
このモデルでは、管理スコープが物理フォルダ階層から切り離されるため、分散チームやマルチプロジェクト アーキテクチャでフォルダ間のガバナンスを実現できます。
コアリソース
タグベースの管理境界は、次の 3 つの Resource Manager リソースを使用して、組織レベルまたはフォルダレベルで定義できます。
- 境界構成（
BoundaryConfig）: 組織レベルまたはフォルダレベルで定義されます。メンバー プロジェクトの分類に使用されるパーティショニング タグキー（123456789012/envなど）を確立します。タグキーが構成されていない場合、その親の下の境界にはすべての子孫プロジェクトが含まれます。 - 境界（
Boundary）: 組織またはフォルダ内の論理パーティション。有効なタグ値が一致するプロジェクト（env=prodなど）、または親BoundaryConfigにタグキーが構成されていない場合は、すべての子孫プロジェクトが境界に動的に含まれます。 - 機能構成（
CapabilityConfig）: 組織、フォルダ、またはプロジェクト レベルで定義されます。組織レベルまたはフォルダレベルでは、1 つ以上の境界を指定された管理プロジェクトに関連付け、境界全体で有効にする管理機能を指定します。プロジェクト レベルでは、境界のない単一のスタンドアロン プロジェクトの管理機能が有効になります。
サポートされている機能
機能構成では、次の管理エクスペリエンスがサポートされています。
AGENT_MANAGEMENT（gcloud CLI:agent-management）: Agent Registry で、一元化された検出、ID レジストリ、プロジェクト間のエージェント ガバナンスを有効にします。
動的メンバーシップとタグの継承
境界内のプロジェクト メンバーシップは、タグとリソース階層の変更に応じて動的に更新されます。
- タグ バインディング: 一致するタグ値をプロジェクトにバインドすると、プロジェクトはすぐに境界に結合されます。境界が
CapabilityConfigに関連付けられている場合、そのCapabilityConfigで有効になっているサービスは、CapabilityConfigの管理プロジェクトを介してプロジェクトのリソースを検出して管理します。 - タグの継承: 親フォルダまたは組織に適用されたタグは、子プロジェクトに継承されます。子プロジェクトは、別のタグ値で明示的にオーバーライドされない限り、境界メンバーシップを継承します。
- タグの削除または更新: プロジェクトのタグのバインドを解除または変更すると、基盤となるインフラストラクチャを削除せずに、プロジェクトが境界から削除されます。
- プロジェクトとフォルダのライフサイクルの変更: プロジェクトが作成、削除取り消し、またはフォルダや組織に移動され（直接またはフォルダ移動の一部として）、境界条件（一致するタグフィルタ、または親
BoundaryConfigにタグキーが構成されていない）に一致すると、自動的に境界に含まれます。プロジェクトが削除または移動されると、境界から自動的に削除されます。
1 つの親フォルダまたは組織内では、境界は相互に排他的です。親ノードの BoundaryConfig は単一のタグキーを使用し、プロジェクトはタグキーごとに 1 つの有効なタグ値のみを持つことができるため、プロジェクトは親ノードごとに最大 1 つの境界に属することができます。リソース階層内の複数の祖先ノード（組織と子フォルダなど）に境界を構成する場合、子孫プロジェクトは各祖先レベルで最大 1 つの境界に属することができます。