アノテーションとラベル

Infrastructure Manager では、アノテーションとラベルを使用できます。必須ではありません。このドキュメントでは、ラベルとアノテーションを添付できるリソースと、それらを使用する方法と表示できる場所について説明します。Infra Manager でアノテーションまたはラベルを使用するには、--annotation フラグと --label フラグを使用します。

アノテーションとラベルとは

アノテーションは、自由形式のテキストの 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でインフラストラクチャを標準化し、再利用してスケーリングします。