Infrastructure Manager では、アノテーションとラベルを使用して、デプロイにオプションのメタデータを追加できます。これらの Key-Value ペアは、 Google Cloud全体でデプロイを整理、追跡、フィルタリングするのに役立ちます。
アノテーションとラベルとは
アノテーションは、自由形式のテキストの Key-Value ペアです。これらを使用して、リソースに関連付けられた任意の情報を付加できます。
ラベルを使用すると、リソースを整理できます。たとえば、ラベルの選択に基づいてロジックを適用できます。
アノテーションは、通常、クライアント ツールがリソースに添付された任意のデータを保存するために使用する、個人を特定できない情報を保存するために使用されます。一方、ラベルは通常、リソースを整理するために使用されます。
Google Cloudでアノテーションを使用する方法については、アノテーション AIP のドキュメントをご覧ください。ラベルの使用について詳しくは、ラベルの概要のドキュメントをご覧ください。
アノテーションとラベルの制約
アノテーションと同様に、ラベルは次の制限に準拠する必要がある Key-Value ペアです。
- キーと値はどちらも 128 バイト以下にする必要があります。
- キーと値には、小文字、数字、アンダースコア、ダッシュのみを使用できます。
- キーは、小文字または国際文字で始める必要があります。
すべての文字には UTF-8 エンコーディングを使用する必要があります。 国際文字も使用できます。次に例を示します。
--annotation="appVersion=v.1.2.3,environment=production"
Infra Manager でアノテーションとラベルを使用する
アノテーションとラベルは、 Google Cloud インフラストラクチャ全体でさまざまな方法で適用できます。
Infra Manager でデプロイを作成または更新するときに、アノテーションとラベルを使用して、デプロイのモニタリングや情報のセットのクエリを行うことができます。詳細については、Infra Manager を使用してインフラストラクチャをデプロイする、デプロイを更新する、デプロイをプレビューするをご覧ください。
次のステップ
Infra Manager を使用して、 Google Cloudでインフラストラクチャを標準化、再利用、スケーリングします。