組織を対象にしたリソース

Config Connector は、プロジェクト、フォルダ、組織レベルでリソースを管理できます。Config Connector は、リソースを作成する場所を決定するために、リソース仕様でスコープを定義するフィールドリを確認し、見つからない場合は、スコープを定義するアノテーションを確認します。

`organizationRef` フィールドを指定する

組織スコープの Config Connector リソースの大半は、その CRD 仕様で organizationRef という名前のフィールドをサポートしています。このフィールドを使用して、リソースを作成する Google Cloud 組織を指定します。

external フィールドを使用して、組織 ID を指定できます。値の厳密な形式は、リソースタイプによって異なる場合があります。最も一般的な形式は「ORGANIZATION_ID」と「organizations/ORGANIZATION_ID」です。「ORGANIZATION_ID」の例を以下に示します。

...
spec:
  organizationRef:
    external: "ORGANIZATION_ID"
...

リソース構成にアノテーションを付ける

Config Connector リソースが組織スコープとなっているが organizationRef フィールドをサポートしていない場合は、organization-id アノテーションを使用して組織 ID をリソース構成に設定できます。

...
metadata:
  annotations:
    cnrm.cloud.google.com/organization-id: ORGANIZATION_ID
...

リソースの YAML にこのアノテーションが含まれている例を次に示します。

apiVersion: foo.cnrm.cloud.google.com/v1beta1
kind: FooBar
metadata:
  annotations:
    cnrm.cloud.google.com/organization-id: ORGANIZATION_ID
  name: foobarname

名前空間構成にアノテーションを付ける

Kubernetes 名前空間にアノテーションを付けることにより、新しく作成されるリソースのデフォルトの組織 ID を設定できます。名前空間内のいずれかのリソースに、このアノテーションが独自の構成で明示的に設定されている場合、リソースレベルのアノテーションは名前空間レベルのアノテーションを上書きします。

コマンドラインを使用して名前空間にアノテーションを付けるには、次のコマンドを実行します。

kubectl annotate namespace NAMESPACE_NAME cnrm.cloud.google.com/organization-id=ORGANIZATION_ID

以下を置き換えます。

NAMESPACE_NAME: 名前空間名
ORGANIZATION_ID: Google Cloud 組織 ID。

または、アノテーションを含む YAML マニフェストを適用することもできます。以下の YAML をファイルにコピーします。

apiVersion: v1
kind: Namespace
metadata:
  annotations:
    cnrm.cloud.google.com/organization-id: ORGANIZATION_ID
  name: NAMESPACE_NAME