Cloud Run 標籤是套用至 Cloud Run worker 集區的鍵/值組合。本頁說明如何設定、修改及刪除 Cloud Run 工作站集區的標籤。請注意,在 Cloud Run 工作站集區中設定標籤時,系統會為該工作站集區建立含有這個標籤的新修訂版本,且不會將標籤套用至舊版修訂版本。
可能的用途包括:
- 費用分配和帳單明細。
- 找出個別團隊或成本中心使用的資源。
- 區分部署環境 (正式、測試、QA 或測試)。
- 找出擁有者和狀態標籤。
- 在 Logging 中篩選記錄。
標籤使用規則
使用 Cloud Run 工作站集區設定的標籤時,須遵守下列規則:
Cloud Run 只能使用有效 Google Cloud 標籤。
必要的角色
如要取得設定及部署 Cloud Run 工作站集區所需的權限,請要求管理員授予下列 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 用戶端程式庫) 介接,請參閱服務身分設定指南。如要進一步瞭解如何授予角色,請參閱部署權限和管理存取權。
設定或修改標籤
變更任何設定都會建立新的修訂版本。除非您明確做出更新,變更這項設定,否則後續的修訂版本也會自動取得這個設定。
建立新 worker 集區或部署新修訂版本時,可以使用 Google Cloud CLI 設定或修改標籤:
gcloud
您可以使用下列指令更新工作站集區的標籤:
gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE
如要更新多個標籤,請提供以逗號分隔的鍵/值組合清單。請注意,如果標籤已存在,update-labels
指令會為標籤鍵設定新值,否則會建立新標籤。
取代:
- WORKER_POOL,並將其替換為 Cloud Run 工作站集區的名稱
- KEY 改為標籤鍵的名稱
- VALUE,並提供索引鍵的值
您也可以在部署期間設定標籤:
gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE
如要在部署期間建立多個標籤,請提供以半形逗號分隔的鍵/值組合清單。
依標籤列出服務
您可以使用 Google Cloud CLI 篩選器,依標籤列出服務:
gcloud beta run worker-pools list --filter metadata.labels.LABEL=VALUE
取代:
- 將 LABEL 替換為標籤名稱
- VALUE,然後輸入要納入篩選清單的值
刪除工作站集區的標籤
您可以使用 Google Cloud CLI 刪除 worker 集區的標籤。
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 改為標籤名稱