Cloud Run ラベルは、Cloud Run ワーカープールに適用される Key-Value ペアです。このページでは、Cloud Run ワーカープールでラベルを設定、変更、削除する方法について説明します。Cloud Run ワーカープールにラベルを設定すると、このラベルが付いた新しいリビジョンがこのサービスに作成されます。古いリビジョンにはラベルは適用されません。
たとえば、次のような用途が考えられます。
- 費用の割り当てと請求の内訳
- 個々のチームやコストセンターで使用されているリソースを特定する
- デプロイ環境(本番、ステージング、検証、テスト)を区別する
- 所有者と状態のラベルを特定する
- Logging でログをフィルタする
ラベルの使用ルール
Cloud Run ワーカープールで設定されたラベルを使用する場合、次のルールが適用されます。
Cloud Run で使用できるのは、有効な Google Cloud ラベルのみです。
必要なロール
Cloud Run のワーカープールの構成とデプロイに必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。
-
Cloud Run のワーカープールに対する Cloud Run デベロッパー(
roles/run.developer
) -
サービス ID に対するサービス アカウント ユーザー(
roles/iam.serviceAccountUser
)
Cloud Run に関連付けられている IAM ロールと権限のリストについては、Cloud Run IAM ロールと Cloud Run IAM 権限をご覧ください。Cloud Run ワーカープールがGoogle Cloud API(Cloud クライアント ライブラリなど)と連携している場合は、サービス ID の構成ガイドをご覧ください。ロールの付与の詳細については、デプロイ権限とアクセスの管理をご覧ください。
ラベルを設定または変更する
構成を変更すると、新しいリビジョンが作成されます。明示的に更新しない限り、以降のリビジョンでも、この構成が自動的に設定されます。
ラベルを設定または変更するには、 Google Cloud コンソール、Google Cloud CLI、または Terraform を使用します。
コンソール
Google Cloud コンソールで Cloud Run に移動します。
ワーカープールを見つけて、名前の左側にあるチェックボックスをオンにします。
[ラベル] をクリックして、ラベルペインを表示します。
既存のラベルキーの値を編集するには、ラベルを見つけて、値を必要に応じて変更します。
ワーカープールに新しいラベルを設定するには、[ラベルを追加] をクリックしてキーと値を指定します。
[保存] をクリックします。
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 ペアのカンマ区切りのリストを指定します。
Terraform
Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。
resource "google_cloud_run_v2_worker_pool" "default" {
name = "WORKER_POOL"
location = "REGION"
launch_stage = "BETA"
template {
containers {
image = "IMAGE_URL"
}
}
labels = {
KEY : "VALUE"
}
}
次のように置き換えます。
- WORKER_POOL: ワーカープールの名前
- REGION: Google Cloud リージョン(例:
europe-west1
) - IMAGE_URL: ワーカープールを含むコンテナ イメージへの参照(
us-docker.pkg.dev/cloudrun/container/worker-pool:latest
など) - KEY: ラベルキーの名前
- VALUE: キーの値
ラベル別にサービスを一覧表示する
Google Cloud CLI フィルタを使用して、ラベル別にサービスを一覧取得できます。
gcloud beta run worker-pools list --filter metadata.labels.LABEL=VALUE
次のように置き換えます。
- LABEL: ラベルの名前
- VALUE: フィルタ後のリストに含める値
ワーカープールのラベルを削除する
Google Cloud コンソールまたは Google Cloud CLI を使用して、ワーカープールのラベルを削除できます。
コンソール
Google Cloud コンソールで Cloud Run に移動します。
ワーカープールを見つけて、名前の左側にあるチェックボックスをオンにします。
[ラベル] をクリックして、ラベルペインを表示します。
削除するラベルを見つけます。
ラベルの [値] テキスト ボックスの右にカーソルを合わせ、表示されるゴミ箱アイコンをクリックします。
[保存] をクリックします。
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: ラベルの名前