設定執行個體的標籤

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 相關聯的 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

  1. 如果您要建立新的執行個體,請略過這個步驟。如要更新現有執行個體,請下載其 YAML 設定:

    gcloud beta run instances describe INSTANCE --format export > instance.yaml
  2. 以下範例包含 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 會在執行個體物件上設定標籤。

  3. 使用下列指令建立或更新執行個體:

    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:標籤名稱。