Cloud Run 標籤是套用至 Cloud Run worker 集區的鍵/值組合。本頁面說明如何設定、修改及刪除 Cloud Run worker 集區的標籤。請注意，為 Cloud Run worker 集區設定標籤時，系統會為這個 worker 集區建立含有這個標籤的新修訂版本，但不會將標籤套用至舊版修訂版本。
可能用途包括：
- 成本分配和帳單明細。
- 找出個別團隊或成本中心使用的資源。
- 區分部署環境 (實際工作環境、測試環境、品質確保環境或測試環境)。
- 找出擁有者和狀態標籤。
- 在 Logging 中篩選記錄。
標籤使用規則
下列規則適用於 Cloud Run worker 集區設定的標籤：
Cloud Run 只能使用有效 Google Cloud 標籤。
帳單資料和記錄的標籤
Cloud Billing 只會接收 YAML 中metadata.labels 屬性指定的標籤，或 Terraform 中頂層 labels 引數指定的標籤。Cloud Logging 只會接收 YAML 中 spec.template.metadata.labels 屬性或 Terraform 中 template 下指定的標籤。如要將標籤傳播至 Cloud Billing 和 Cloud Logging，請在使用 YAML 或 Terraform 時，在兩個位置都指定標籤。如果您使用 Google Cloud 控制台或 Google Cloud CLI 設定標籤，Cloud Run 會將標籤新增至 metadata.labels 和 spec.template.metadata.labels 屬性。必要的角色
如要取得設定及部署 Cloud Run worker 集區所需的權限，請要求管理員授予您下列 IAM 角色：
- Cloud Run worker 集區的 Cloud Run 開發人員 (
roles/run.developer) - 服務身分的服務帳戶使用者 (
roles/iam.serviceAccountUser)
如要查看與 Cloud Run 相關聯的 IAM 角色和權限清單，請參閱「Cloud Run IAM 角色」和「Cloud Run IAM 權限」。如果 Cloud Run worker 集區與Google Cloud API (例如 Cloud 用戶端程式庫) 介接，請參閱服務身分設定指南。如要進一步瞭解如何授予角色，請參閱「部署權限」和「管理存取權」。
設定或修改標籤
任何設定變更都會建立新的修訂版本。後續修訂版本也會自動套用這項設定，除非您明確更新設定。
您可以使用 Google Cloud 控制台、Google Cloud CLI、YAML 或 Terraform 設定或修改標籤：
控制台
前往 Google Cloud 控制台的「Cloud Run」頁面：
找到 worker 集區，然後勾選名稱左側的核取方塊。
按一下「標籤」，顯示「標籤」窗格。
如要編輯現有的標籤鍵值，請找出標籤，然後視需要變更「Value」(值)。
如要為 worker 集區設定新標籤，請按一下「Add Label」(新增標籤)，然後提供鍵和值。
按一下「儲存」
gcloud
您可以使用下列指令，更新 worker 集區的標籤：
gcloud run worker-pools update WORKER_POOL --update-labels KEY=VALUE
如要更新多個標籤，請提供以半形逗號分隔的鍵/值組合清單。請注意，如果標籤已存在，update-labels 指令會為標籤鍵設定新值，否則會建立新標籤。
更改下列內容：
- WORKER_POOL：Cloud Run worker 集區的名稱
- KEY：標籤鍵名稱
- VALUE：鍵的值
您也可以在部署期間設定標籤：
gcloud run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE
如要在部署期間建立多個標籤，請提供以半形逗號分隔的鍵/值組合清單。
YAML
如果您要建立新的 worker 集區，請略過這個步驟。如要更新現有 worker 集區，請下載其 YAML 設定：
gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
在兩個位置更新
labels屬性：apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL labels: KEY: VALUE KEY2: VALUE2 KEY3: VALUE3 spec: template: metadata: labels: KEY: VALUE KEY2: VALUE2 KEY3: VALUE3
更改下列內容：
- WORKER_POOL：Cloud Run worker 集區的名稱
- KEY 和 VALUE：標籤的鍵/值組合
metadata.labels會在 worker 集區物件上設定標籤，而spec.template.metadata.labels則會在建立的修訂版本上設定標籤。Cloud Run 會將metadata.labels中設定的標籤傳播至 Cloud Billing，並將spec.template.metadata.labels中設定的標籤傳播至 Cloud Logging。使用下列指令建立或更新 worker 集區：
gcloud run worker-pools replace worker-pool.yaml
gcloud run worker-pools replace指令預設會使用worker-pool.yaml檔案 (如有)。
Terraform
如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。
resource "google_cloud_run_v2_worker_pool" "default" {
name = "WORKER_POOL"
location = "REGION"
template {
containers {
image = "IMAGE_URL"
}
labels = {
"KEY" : "VALUE"
}
}
labels = {
"KEY" : "VALUE"
}
}
更改下列內容：
- WORKER_POOL：worker 集區的名稱
- REGION： Google Cloud 區域，例如
europe-west1 IMAGE_URL：參照含有 worker 集區的容器映像檔，例如us-docker.pkg.dev/cloudrun/container/worker-pool:latest- KEY：標籤鍵名稱
- VALUE：鍵的值
頂層 labels 引數會設定 worker 集區的標籤，而 template 下方的 labels 引數則會設定修訂版本的標籤。Cloud Run 會將頂層 labels 傳播至 Cloud Billing，並將 template 下設定的 labels 傳播至 Cloud Logging。
依標籤列出 worker 集區
您可以使用 Google Cloud CLI 篩選器，依標籤列出 worker 集區：
gcloud run worker-pools list --filter metadata.labels.LABEL=VALUE
更改下列內容：
- LABEL：標籤名稱
- VALUE：要納入篩選清單的值
刪除 worker 集區的標籤
您可以使用 Google Cloud 控制台或 Google Cloud CLI，刪除 worker 集區的標籤。
控制台
前往 Google Cloud 控制台的「Cloud Run」頁面：
找到 worker 集區，然後勾選名稱左側的核取方塊。
按一下「標籤」，顯示「標籤」窗格。
找出要刪除的標籤。
將游標懸停在標籤「Value」(值) 文字方塊右側，顯示垃圾桶圖示，然後按一下垃圾桶圖示。
按一下「儲存」
gcloud
如要清除 worker 集區的所有標籤，請按照下列步驟操作：
gcloud run worker-pools update WORKER_POOL --clear-labels
如要從 worker 集區刪除特定標籤，請提供以半形逗號分隔的鍵清單：
gcloud run worker-pools update WORKER_POOL --remove-labels LABEL
更改下列內容：
- WORKER_POOL：Cloud Run worker 集區的名稱
- LABEL：標籤名稱