4.6. GCP のユーザー定義のラベルとタグの管理


Google Cloud Platform (GCP) は、特定の OpenShift Container Platform クラスター用に作成されたリソースの識別と整理に役立つラベルとタグを提供し、管理を容易にします。

各 GCP リソースのラベルとタグは、OpenShift Container Platform クラスターのインストール中にのみ定義できます。

重要

ユーザー定義のラベルとタグは、OpenShift Container Platform 4.19 にアップグレードされた OpenShift Container Platform クラスターではサポートされません。

注記

すでに追加されているタグを更新することはできません。また、設定されたタグキーまたはタグ値が削除された場合、タグによってサポートされるリソースの新規作成が失敗します。

ユーザー定義のラベル

ユーザー定義のラベルと OpenShift Container Platform 固有のラベルは、OpenShift Container Platform インストールプログラムとそのコアコンポーネントによって作成されたリソースにのみ適用されます。

  • GCP ファイルストアの CSI ドライバーオペレーター
  • GCP PD CSI Driver Operator
  • Image Registry Operator
  • GCP 用のマシン API プロバイダー

ユーザー定義のラベルは、他の Operator または Kubernetes のツリー内コンポーネントによって作成されたリソースには割り当てられません。

ユーザー定義のラベルと OpenShift Container Platform ラベルは、次の GCP リソースで使用できます。

  • コンピュートディスク
  • コンピュート転送ルール
  • コンピュートイメージ
  • コンピュートインスタンス
  • DNS 管理ゾーン
  • ファイルストアのバックアップ
  • ファイルストアインスタンス
  • ストレージバケット

ユーザー定義ラベルの制限

  • ComputeAddress のラベルは GCP ベータ版でサポートされています。OpenShift Container Platform はリソースにラベルを追加しません。

ユーザー定義のタグ

ユーザー定義のタグは、OpenShift Container Platform インストールプログラムとそのコアコンポーネントによって作成されたリソース (次のリソースなど) にのみ適用されます。

  • GCP FileStore CSI Driver Operator
  • GCP PD CSI Driver Operator
  • Image Registry Operator
  • GCP 用のマシン API プロバイダー

ユーザー定義のタグは、他の Operator または Kubernetes のツリー内コンポーネントによって作成されたリソースには割り当てられません。

ユーザー定義のタグは、次の GCP リソースで利用できます。

  • コンピュートディスク
  • コンピュートインスタンス
  • ファイルストアのバックアップ
  • ファイルストアインスタンス
  • ストレージバケット

ユーザー定義タグの制限事項

  • Operator は最小限のロールを持つサービスアカウントを作成して使用するため、タグを特定のサービスアカウントに制限してはなりません。
  • OpenShift Container Platform は、タグのキーおよび値のリソースを作成しません。
  • OpenShift Container Platform 固有のタグはどのリソースにも追加されません。

4.6.1. ユーザー定義のラベルとタグの基準

Google Cloud Platform のユーザー定義のラベルとタグを設定する前に、適切なリソースガバナンスを確保するために、これらのタグとラベルの要件を満たすことの重要性を考慮してください。

次のリストは、ユーザー定義ラベルの要件の詳細を示しています。

  • ラベルのキーと値は、最小 1 文字、最大 63 文字である必要があります。
  • ラベルのキーと値には、小文字、数字、アンダースコア (_)、ダッシュ (-) のみを含める必要があります。
  • ラベルキーは小文字で始まる必要があります。
  • リソースごとに最大 32 個のラベルを設定できます。

    • 各リソースのラベルは最大 64 個です。OpenShift Container Platform は内部使用のために 32 個のラベルを予約します。

次のリストは、ユーザー定義タグの要件の詳細を示しています。

  • タグのキーと値がすでに存在している必要があります。OpenShift Container Platform はキーと値を作成しません。
  • タグの parentID は、OrganizationID または ProjectID のいずれかになります。

    • OrganizationID は、先行ゼロのない 10 進数で構成されている必要があります。
    • ProjectID は、6 - 30 文字の長さで、小文字、数字、ハイフンのみで指定する必要があります。
    • ProjectID は文字で始まる必要があり、ハイフンで終わることはできません。
  • タグのキーには、大文字と小文字の英数字、ハイフン (-)、アンダースコア (_)、ピリオド (.) のみを含める必要があります。
  • タグの値には、大文字と小文字の英数字と次の文字のみを含める必要があります。

    • コロン (:)
    • コンマ (,)
    • 中括弧 ({})
    • ハイフン (-)
    • 丸括弧 (())
    • パーセント記号 (%)
    • プラス (+)
    • ポンド記号 ($)
    • スペース
    • 角括弧 ([])
    • アンパサンド (&)
    • アスタリスク (*)
    • アットマーク (@)
    • 等号 (=)
    • アンダースコア (_)
    • ピリオド (.)
  • タグのキーと値の先頭と末尾は、英数字である必要があります。
  • タグの値は、そのキーに対して事前定義された値のいずれかである必要があります。
  • 最大 50 個のタグを設定できます。
  • 親リソースから継承された既存のタグキーと同じ値を持つタグキーを定義しないでください。

4.6.2. GCP のユーザー定義のラベルとタグの設定

Google Cloud Platform のユーザー定義のラベルとタグを設定すると、インフラストラクチャーを整理、管理、自動化する目的で、クラウドリソースにキーと値のペアを適用できます。

前提条件

  • インストールプログラムでは、組織レベルとプロジェクトレベルの両方で定義されたタグを使用してプログラムが OpenShift Container Platform クラスターを作成できるように、サービスアカウントに TagUser ロールが含まれている必要があります。

手順

  • install-config.yaml ファイルを更新して、必要なラベルとタグのリストを定義します。

    注記

    install-config.yaml 設定ファイルの作成時にラベルとタグを設定した場合、クラスターの作成後に新しいラベルとタグを作成したり、既存のラベルとタグを更新したりすることはできません。

    install-config.yaml ファイルのサンプル

    apiVersion: v1
    credentialsMode: Passthrough 
    1
    
    platform:
     gcp:
       userLabels: 
    2
    
       - key: <label_key>
    3
    
         value: <label_value>
    4
    
       userTags: 
    5
    
       - parentID: <OrganizationID/ProjectID>
    6
    
         key: <tag_key_short_name>
         value: <tag_value_short_name>
    # ...
    Copy to Clipboard Toggle word wrap

    1
    passthrough モードでは、Cloud Credential Operator (CCO) は提供されるクラウド認証情報を、コンポーネントを要求するコンポーネントに渡します。
    2
    GCP で作成されたリソースにキーと値をラベルとして追加します。
    3
    ラベル名を定義します。
    4
    ラベルの内容を定義します。
    5
    GCP 上で作成したリソースにキーと値をタグとして追加します。
    6
    タグを定義した階層リソース (組織またはプロジェクト) の ID。

4.6.3. GCP のユーザー定義のラベルとタグの照会

OpenShift Container Platform クラスターを作成した後、次のサンプル infrastructure.yaml ファイルに示すように、infrastructures.config.openshift.io/cluster オブジェクト内の GCP リソースに定義されたラベルとタグのリストにアクセスできます。

サンプルの infrastructure.yaml ファイル

apiVersion: config.openshift.io/v1
kind: Infrastructure
metadata:
 name: cluster
spec:
 platformSpec:
   type: GCP
status:
 infrastructureName: <cluster_id>
1

 platform: GCP
 platformStatus:
   gcp:
     resourceLabels:
     - key: <label_key>
       value: <label_value>
     resourceTags:
     - key: <tag_key_short_name>
       parentID: <OrganizationID/ProjectID>
       value: <tag_value_short_name>
   type: GCP
Copy to Clipboard Toggle word wrap

1
クラスターのインストール中に生成されるクラスター ID。

ユーザー定義のラベルに加えて、リソースには OpenShift Container Platform によって定義されたラベルがあります。OpenShift Container Platform ラベルの形式は、kubernetes-io-cluster-<cluster_id>:owned です。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat