Cloud Run 標籤是套用至 Cloud Run worker 集區的鍵/值組合。本頁說明如何設定、修改及刪除 Cloud Run 工作站集區的標籤。請注意，在 Cloud Run 工作站集區中設定標籤時，系統會為該工作站集區建立含有這個標籤的新修訂版本，且不會將標籤套用至舊版修訂版本。
可能的用途包括：
- 費用分配和帳單明細。
- 找出個別團隊或成本中心使用的資源。
- 區分部署環境 (正式、測試、品質確保或測試)。
- 找出擁有者和狀態標籤。
- 在 Logging 中篩選記錄。
標籤使用規則
使用 Cloud Run 工作站集區設定的標籤時，請遵守下列規則：
Cloud Run 只能使用有效 Google Cloud 標籤。
必要的角色
如要取得設定及部署 Cloud Run worker 集區所需的權限，請要求管理員授予下列 IAM 角色：
-
Cloud Run 開發人員 (
roles/run.developer) 在 Cloud Run worker 集區上 -
服務帳戶使用者 (
roles/iam.serviceAccountUser) 服務身分
如需與 Cloud Run 相關聯的 IAM 角色和權限清單，請參閱 Cloud Run IAM 角色和 Cloud Run IAM 權限。如果 Cloud Run 工作站集區與Google Cloud API (例如 Cloud 用戶端程式庫) 介接，請參閱服務身分設定指南。如要進一步瞭解如何授予角色，請參閱部署權限和管理存取權。
設定或修改標籤
變更任何設定都會建立新的修訂版本。除非您明確做出更新，改變這項設定，否則後續的修訂版本也會自動取得這個設定。
您可以使用 Google Cloud 控制台、Google Cloud CLI 或 Terraform 設定或修改標籤：
控制台
前往 Google Cloud 控制台的 Cloud Run：
找到工作站集區，然後選取名稱左側的核取方塊。
按一下「標籤」即可顯示「標籤」窗格。
如要編輯現有標籤鍵值，請找出標籤並視需要變更「值」。
如要在工作者集區中設定新標籤，請按一下「新增標籤」，然後提供鍵和值。
點選「儲存」。
gcloud
您可以使用下列指令更新工作站集區的標籤：
gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE
如要更新多個標籤，請提供以逗號分隔的鍵/值組合清單。請注意，如果標籤已存在，update-labels 指令會為標籤鍵設定新值，否則會建立新標籤。
更改下列內容：
- WORKER_POOL：Cloud Run worker 集區的名稱
- KEY：標籤鍵的名稱
- VALUE：鍵的值
您也可以在部署期間設定標籤：
gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE
如要在部署期間建立多個標籤，請提供以半形逗號分隔的鍵/值組合清單。
YAML
如要建立新的工作站集區，請略過這個步驟。 如要更新現有工作站集區，請下載其 YAML 設定：
gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml
以下範例包含 YAML 設定：
apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL labels: KEY: VALUE KEY2: VALUE2 KEY3: VALUE3 annotations: run.googleapis.com/launch-stage: BETA
更改下列內容：
- WORKER_POOL：Cloud Run worker 集區的名稱
- KEY 和 VALUE：標籤的鍵/值組合
使用下列指令建立或更新工作站集區：
gcloud beta run worker-pools replace workerpool.yaml
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 刪除 worker 集區的標籤。
控制台
前往 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 worker 集區的名稱
- LABEL：標籤名稱