ワーカープールにラベルを構成する

Cloud Run ラベルは、Cloud Run ワーカープールに適用される Key-Value ペアです。このページでは、Cloud Run ワーカープールでラベルを設定、変更、削除する方法について説明します。Cloud Run ワーカープールにラベルを設定すると、このラベルが付いた新しいリビジョンがこのサービスに作成されます。古いリビジョンにはラベルは適用されません。

たとえば、次のような用途が考えられます。

  • 費用の割り当てと請求の内訳
  • 個々のチームやコストセンターで使用されているリソースを特定する
  • デプロイ環境（本番、ステージング、検証、テスト）を区別する
  • 所有者と状態のラベルを特定する
  • Logging でログをフィルタする

ラベルの使用ルール

Cloud Run ワーカープールで設定されたラベルを使用する場合、次のルールが適用されます。

Cloud Run で使用できるのは、有効な Google Cloud ラベルのみです。

必要なロール

Cloud Run のワーカープールの構成とデプロイに必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

Cloud Run に関連付けられている IAM ロールと権限のリストについては、Cloud Run IAM ロールと Cloud Run IAM 権限をご覧ください。Cloud Run ワーカープールがGoogle Cloud API（Cloud クライアント ライブラリなど）と連携している場合は、サービス ID の構成ガイドをご覧ください。ロールの付与の詳細については、デプロイ権限とアクセスの管理をご覧ください。

ラベルを設定または変更する

構成を変更すると、新しいリビジョンが作成されます。明示的に更新しない限り、以降のリビジョンでも、この構成が自動的に設定されます。

新しいワーカープールを作成するとき、または新しいリビジョンをデプロイするときに、Google Cloud CLI を使用してラベルを設定または変更できます。

gcloud

次のコマンドを使用して、ワーカープールのラベルを更新できます。

gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE

複数のラベルを更新するには、Key-Value ペアのカンマ区切りリストを指定します。ラベルがすでに存在する場合、update-labels コマンドはラベルキー用に新しい値を設定します。それ以外の場合は、新しいラベルを作成します。

次のように置き換えます。

  • WORKER_POOL は、Cloud Run ワーカープールの名前に置き換えます。
  • KEY は、ラベルキーの名前に置き換えます。
  • VALUE は、キーの値に置き換えます。

デプロイ中にラベルを設定することもできます。

gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE

デプロイ中に複数のラベルを作成するには、Key-Value ペアのカンマ区切りのリストを指定します。

ラベル別にサービスを一覧表示する

Google Cloud CLI フィルタを使用して、ラベル別にサービスを一覧取得できます。

  gcloud beta run worker-pools list --filter metadata.labels.LABEL=VALUE

次のように置き換えます。

  • LABEL は、ラベルの名前に置き換えます。
  • VALUE は、フィルタ後のリストに含める値に置き換えます。

ワーカープールのラベルを削除する

Google Cloud CLI を使用して、ワーカープールのラベルを削除できます。

gcloud

ワーカープールからラベルをすべて消去するには:

gcloud beta run worker-pools update WORKER_POOL --clear-labels

ワーカープールから特定のラベルを削除するには、キーのカンマ区切りリストを指定します。

gcloud beta run worker-pools update WORKER_POOL --remove-labels LABEL

次のように置き換えます。

  • WORKER_POOL は、Cloud Run ワーカープールの名前に置き換えます。
  • LABEL は、ラベルの名前に置き換えます。