タグは、Google Cloud リソースにアノテーションを付けてポリシーを条件付きで適用するために、リソースに添付できる Key-Value ペアです。この条件付き適用により、 Google Cloud リソース階層全体のリソースをきめ細かく制御できます。
Google Cloudのリソース階層は、リソースをツリー構造に整理して、大規模な管理を可能にします。ただし、この階層は、組織構造、リージョン、ワークロード タイプ、コストセンターなど、一部のビジネス ディメンションをモデル化しているだけです。タグを使用すると、階層全体で複数のビジネス ディメンションを柔軟にレイヤ化できます。
タグとラベル
ラベルは、リソースのアノテーションを作成する別個の方法です。次の表に、タグとラベルの違いをいくつか示します。
| タグ | ラベル | |
|---|---|---|
| リソース構造 | タグキー、タグ値、タグ バインディングはすべて個別のリソース | リソース自体ではなく、リソースのメタデータ |
| 定義 | 組織レベルまたはプロジェクト レベルで定義する | 各リソースによって定義される |
| アクセス制御 | タグの管理と取り付けには、Identity and Access Management(IAM)ロールが必要 | ラベルの取り付けには、サービス リソースに応じて異なる IAM のロールが必要です |
| 取り付けの前提条件 | タグがリソースに取り付け可能になる前にタグキーとタグ値を定義する必要があります | 取り付けの前提条件なし |
| 継承 | タグ バインディングは、 Google Cloud 階層内のリソースの子に継承されます。 | リソースの子には継承されない |
| 削除の要件 | タグは、そのタグのタグ バインディングが存在しない場合を除き、削除できません。 | リソースからいつでも削除可能 |
| 命名の要件 | タグ値とタグキーの要件 | ラベルの要件 |
| Key-Value 名の長さ | 最大 256 文字 | 最大 63 文字 |
| 許可ポリシーと拒否ポリシーのサポート | タグは、許可ポリシーの条件と拒否ポリシーの条件で参照できます。 | 許可ポリシーと拒否ポリシーはサポートされていません |
| 組織のポリシーのサポート | 一部のリソースのタグは、組織のポリシーの条件付き制約で参照できます。 | 組織のポリシーがサポートされていない |
| Cloud Billing の統合 | チャージバック、監査、その他の費用割り当て分析を実行し、Cloud Billing の費用データを BigQuery にエクスポートします。 | Cloud Billing でラベルごとにリソースをフィルタリングし、BigQuery に Cloud Billing データをエクスポートする |
ラベルの詳細については、ラベルの作成と管理をご覧ください。
セマンティック タグ
セマンティック タグは、OpenTelemetry(OTel)規則に裏付けられた強力で標準化されたセマンティクスを使用して、リソースに意味のあるメタデータを提供する Key-Value ペアです。
App Hub リソースでセマンティック タグを使用できます。App Hub でサービスとワークロードに属性を設定すると、App Hub は、直接基盤となるリソースに読み取り専用のシステム セマンティック タグとして属性を自動的に複製します。
システム セマンティック タグは読み取り専用です。Tags API または Google Cloud コンソールを使用して、これらのシステムタグを直接編集または削除することはできません。タグの管理は App Hub 内で行われます。
App Hub の複製されたセマンティック タグ
App Hub を使用している場合、サービスまたはワークロードに設定された環境属性と重要度属性は、専用の名前空間 google:AppHub の下に読み取り専用のシステム セマンティック タグとして自動的に複製されます。
サポートされているシステムタグは次のとおりです。
google:AppHub/environment: App Hub から取得された値(PRODUCTIONやSTAGINGなど)。google:AppHub/criticality: App Hub から取得された値(MISSION_CRITICALやHIGHなど)。
App Hub コンテキストをシステムタグとして表示することで、 Google Cloud コンソールなどのダウンストリーム サービスが信頼できるメタデータを使用して、手動構成に関連するリスクなしにガバナンス ポリシーとセキュリティ ポリシーを適用できます。
セマンティック タグの管理の詳細については、セマンティック タグを表示して管理するをご覧ください。
セマンティック カタログ
セマンティック カタログには、使用可能なセマンティクスと、OpenTelemetry(OTel)に基づく属性へのマッピングのリストが表示されます。このカタログは、 Google Cloud コンソールで参照することも、API を使用して詳細を表示することもできます。
カタログへのアクセスの詳細については、セマンティック カタログを表示するをご覧ください。
| セマンティクス キー | OTel 属性のキー | セマンティクス値 | OTel 属性値 |
|---|---|---|---|
ENVIRONMENT |
deployment.environment.name |
PRODUCTION |
production |
STAGING |
staging |
||
TEST |
test |
||
DEVELOPMENT |
development |
||
CRITICALITY |
service.criticality |
MISSION_CRITICAL |
critical |
HIGH |
high |
||
MEDIUM |
medium |
||
LOW |
low |
セマンティック タグの制限事項
セマンティック タグには次の制限があります。
- カスタム バインディング: Tags API を使用して、
ENVIRONMENTまたはCRITICALITYセマンティック タグをリソースまたは Resource Manager ノード(プロジェクト、フォルダ、組織)に直接バインドすることはできません。 - ユーザー定義のセマンティクス: 既存のタグをセマンティック タグに昇格させることはできません。
- 直接リソースのみ: 同期は、App Hub に登録されている直接リソースにのみ適用されます。サービスまたはワークロード内のネストされたリソースや間接リソース(MIG 内の個々の VM など)には伝播されません。
タグの作成
タグは Key-Value ペアとして構成されます。タグキー リソースは、組織リソースまたはプロジェクト リソースの下に作成できます。タグ値はキーに関連付けられるリソースです。たとえば、値 production と development を持つタグキー environment などです。
タグの管理
管理者は、タグを作成、更新、削除、およびリソースに関連付ける権限を持つユーザーを制限することで、タグの使用を制御できます。個々のタグを選択して、編集(値の追加や削除など)や説明の更新を行うことができます。これにより、タグをきめ細かく制御できます。
タグには、必要に応じて説明を付けることができます。この説明は、タグに関する情報を取得するときに表示されます。この説明は、リソースにタグを適用するユーザーがタグの目的を理解するのに役立ちます。
親プロジェクトまたは組織では、各タグキーは一意である必要があります。これにより、各タグ値がリソースにバインドされるときに、タグキーとの一意のペアが作成されます。
ポリシーとタグ
タグと IAM 条件を組み合わせて使用すると、次のことができます。
タグ値を作成したら、タグ値をリソースにバインドできます。その後、タグキーがリソースにバインドされているかどうかに基づいてリソースを識別する条件付き IAM ポリシーを作成できます。タグと IAM 条件の使用については、タグと条件付きアクセスをご覧ください。
タグの変更による影響
タグを使用して条件付きでアクセスを許可または拒否する場合、または組織のポリシーのスコープを設定する場合、リソースからタグをバインドまたはバインド解除すると、これらのポリシーの影響が変わる可能性があります。
たとえば、Compute Engine インスタンスを管理する必要があるデベロッパーのグループがあり、開発に使用されるインスタンスのみを管理する必要があるとします。
- タグ定義: タグキー
123456789012/envに値devとprodがあります。 - 条件付きアクセス: 開発者グループに Compute インスタンス管理者ロール(
roles/compute.instanceAdmin)を付与します。リソースにタグenv: devがある場合にのみアクセスを許可する条件をロール バインディングに追加します。 - 変更の影響:
- タグのバインド: タグ
env: devをインスタンスに適用します。条件付きロール バインディングにより、デベロッパーにインスタンスを管理するアクセス権が付与されます。 - タグのバインド解除: その後、同じインスタンスが本番環境に昇格されます。
env: devタグのバインドを解除し、env: prodタグをバインドします。条件付きロール バインディングにより、デベロッパーはこのインスタンスを管理するためのアクセス権を付与されなくなります。
- タグのバインド: タグ
通常、タグの変更は 2 分以内に有効になります。ただし、変更がシステム全体に完全に反映されるまでに最大 7 分かかることがあります。この伝播遅延は、アクセス権の付与または取り消しの速度、またはタグのバインドまたはバインド解除後に組織のポリシーが有効になる速度に影響します。
組織のポリシーを使用した必須タグの適用
カスタムの組織のポリシーを使用して、リソースに必須タグを適用できます。必須タグを適用すると、組織のタグ付けポリシーに準拠するリソースのみを作成できます。つまり、リソースは、ポリシーで指定された必須タグキーのタグ値にバインドされます。詳細については、タグを適用するカスタム制約を設定するをご覧ください。
必須タグの適用は、次のリソースタイプでサポートされています。
- Resource Manager のプロジェクトとフォルダ
- Filestore インスタンス
- AlloyDB for PostgreSQL のクラスタとバックアップ リソース
- Workflows ワークフロー
- Compute Engine リソース:
- インスタンス
- ディスク
- 外部 VPN ゲートウェイ
- VPN ゲートウェイ
- ターゲット VPN ゲートウェイ
- VPN トンネル
- 相互接続
- 相互接続のアタッチメント
- バックエンド サービス
- リージョン バックエンド サービス
- バックエンド バケット
- VPC リソース:
- ネットワーク
- サブネットワーク
- ファイアウォール ルール
- ルート
タグの継承
タグ値がリソースに付加されると、デフォルトでは、そのリソースのすべての子孫が同じタグ値を継承します。子孫リソースで継承されたタグ値をオーバーライドできます。継承されたタグ値をオーバーライドするには、別のタグ値を子孫リソースにバインドします。異なるタグ値は、継承されたタグ値と同じタグキーを使用する必要があります。
たとえば、environment: development タグを適用したフォルダに team-a と team-b という名前の 2 つの子フォルダがあるとします。team-b フォルダに別のタグ environment: test を適用することもできます。その結果、team-a フォルダ内のプロジェクトとその他のリソースはタグ environment: development を継承し、team-b フォルダ内のプロジェクトとその他のリソースはタグ environment: test を継承します。
team-b フォルダから environment: test タグを削除すると、そのフォルダとリソースはタグ environment: development を継承します。
リソースによって添付され、継承されるすべてのタグは、集合的に効果的なタグと呼ばれます。リソースで有効なタグは、直接接続されているタグと、階層全体でリソースの祖先のすべてに添付されているすべてのタグを組み合わせたものです。
IAM 条件でタグを使用する場合は、IAM 条件で使用されるタグキーごとに安全なデフォルトのタグ値を作成することをおすすめします。安全なデフォルトのタグ値を組織にバインドして、組織内のすべてのリソースに継承されるようにします。タグ値を変更するには、関連するリソースで継承されたバインディングを明示的にオーバーライドします。
たとえば、enforcement タグキーのタグ値 on に依存する IAM 条件があり、タグキーに off タグ値もあるとします。タグ値 enforcement: off を組織にバインドして、組織内のすべてのリソースに継承される安全なデフォルトを作成します。タグ値 enforcement: on を組織内の選択したリソースにのみバインドします。
その後、enforcement タグキーを処理するポリシーを作成できます。このポリシーには、リソースが enforcement: on または enforcement: off の場合にリソースに影響する条件と、enforcement: default の場合に安全なケースが含まれます。enforcement タグキーがリソースから削除されると、リソースは親リソースから enforcement のタグ値を継承できます。親リソースに enforcement タグキーがない場合、リソースは組織リソースから enforcement: default を継承します。
安全なデフォルト タグを使用すると、意図しない動作を防ぐことができます。ただし、リソースを移動したりタグを削除したりする前に、条件が設定されたタグとポリシーを確認することをおすすめします。
タグのキーと値の削除
タグ値を削除する前に、そのタグ値を使用するすべてのリソース バインディングを削除する必要があります。
タグ値を削除から保護する
タグ値にタグ保留を適用することで、タグ値の保護を強化できます。タグ バインディングと同様に、タグホールドによりユーザーがタグ値を削除できなくなります。
一部のリソースでは、リソースに接続されたタグ値ごとにタグホールドが自動的に作成されます。タグ値を削除するには、このタグホールドを削除する必要があります。
次のステップ
- タグの使用方法の詳細については、タグの作成と管理ページをご覧ください。
- Compute Engine でタグを使用する方法については、リソースのタグの管理をご覧ください。
- タグを使用してプロジェクト間の管理境界を定義する方法については、管理境界と機能の概要をご覧ください。
- ファイアウォール ポリシーにセキュアタグを使用する方法については、セキュアタグを作成して管理するをご覧ください。