Cloud Run 標籤是套用至 Cloud Run 執行個體的鍵/值組合。本頁面說明如何設定、修改及刪除 Cloud Run 執行個體的標籤。
可能用途包括:
- 成本分配和帳單明細。
- 找出個別團隊或成本中心使用的資源。
- 區分部署環境 (prod、staging、qa 或 test)。
- 找出擁有者和狀態標籤。
- 在 Logging 中篩選記錄。
標籤使用規則
下列規則適用於 Cloud Run 執行個體上設定的標籤:
Cloud Run 只能使用有效 Google Cloud 標籤。
帳單資料和記錄的標籤
Cloud Billing 和 Cloud Logging 會接收 YAML 中metadata.labels 屬性指定的標籤,或使用 Google Cloud CLI 指定的標籤。必要的角色
如要取得設定及部署 Cloud Run 執行個體所需的權限,請要求管理員授予您下列 IAM 角色:
- Cloud Run 執行個體的 Cloud Run 開發人員 (
roles/run.developer) - 服務身分的服務帳戶使用者 (
roles/iam.serviceAccountUser)
如要查看與 Cloud Run 相關聯的 IAM 角色和權限清單,請參閱「Cloud Run IAM 角色」和「Cloud Run IAM 權限」。如果 Cloud Run 執行個體與Google Cloud API (例如 Cloud 用戶端程式庫) 介接,請參閱服務身分設定指南。如要進一步瞭解如何授予角色,請參閱「部署權限」和「管理存取權」。
設定或修改標籤
您可以使用 Google Cloud CLI 或 YAML 設定或修改標籤:
gcloud
您可以使用下列指令更新執行個體的標籤:
gcloud beta run instances update INSTANCE --update-labels KEY=VALUE
如要更新多個標籤,請提供以半形逗號分隔的鍵/值組合清單。請注意,如果標籤已存在,update-labels 指令會為標籤鍵設定新值,否則會建立新標籤。
更改下列內容:
- INSTANCE:Cloud Run 執行個體的名稱。
- KEY:標籤鍵名稱。
- VALUE:鍵的值。
您也可以在部署期間設定標籤:
gcloud beta run instances deploy INSTANCE --image IMAGE --labels KEY=VALUE
如要在部署期間建立多個標籤,請提供以半形逗號分隔的鍵/值組合清單。
YAML
如果您要建立新的執行個體,請略過這個步驟。如要更新現有執行個體,請下載其 YAML 設定:
gcloud beta run instances describe INSTANCE --format export > instance.yaml
以下範例包含 YAML 設定:
apiVersion: run.googleapis.com/v1 kind: Instance metadata: name: INSTANCE annotations: run.googleapis.com/launch-stage: BETA labels: KEY: VALUE KEY2: VALUE2 KEY3: VALUE3
更改下列內容:
- INSTANCE:Cloud Run 執行個體的名稱。
- KEY 和 VALUE:標籤的鍵/值組合。
metadata.labels會在執行個體物件上設定標籤。使用下列指令建立或更新執行個體:
gcloud beta run instances replace instance.yaml
依標籤列出執行個體
您可以使用 Google Cloud CLI 篩選器,依標籤列出執行個體:
gcloud beta run instances list --filter metadata.labels.LABEL=VALUE
更改下列內容:
- LABEL:標籤名稱。
- VALUE:要納入篩選清單的值。
刪除執行個體的標籤
您可以使用 Google Cloud CLI 刪除執行個體的標籤。
gcloud
如要清除執行個體的所有標籤,請按照下列步驟操作:
gcloud beta run instances update INSTANCE --clear-labels
如要從執行個體中刪除特定標籤,請提供以半形逗號分隔的鍵清單:
gcloud beta run instances update INSTANCE --remove-labels LABEL
更改下列內容:
- INSTANCE:Cloud Run 執行個體的名稱。
- LABEL:標籤名稱。