設定執行個體的標籤

Cloud Run 標籤是套用至 Cloud Run 執行個體的鍵/值組合。本頁面說明如何設定、修改及刪除 Cloud Run 執行個體上的標籤。請注意，在 Cloud Run 執行個體上設定標籤時，系統會為該執行個體建立含有這個標籤的新修訂版本，標籤不會套用至舊版修訂版本。

可能的用途包括：

  • 費用分配和帳單明細。
  • 找出個別團隊或成本中心使用的資源。
  • 區分部署環境 (正式、測試、QA 或測試)。
  • 找出擁有者和狀態標籤。
  • 在 Logging 中篩選記錄。

標籤使用規則

下列規則適用於 Cloud Run 執行個體上設定的標籤：

Cloud Run 只能使用有效 Google Cloud 標籤。

帳單資料和記錄的標籤

Cloud Billing 和 Cloud Logging 只會接收 YAML 中 spec.template.metadata.labels 屬性或 Terraform 中 template 下指定的標籤。如果您使用 Google Cloud CLI 設定標籤，Cloud Run 會將標籤新增至 metadata.labels 和 spec.template.metadata.labels 屬性。

必要的角色

如要取得設定及部署 Cloud Run 執行個體所需的權限，請要求管理員授予您下列 IAM 角色：

如需與 Cloud Run 相關聯的 IAM 角色和權限清單，請參閱「Cloud Run IAM 角色」和「Cloud Run IAM 權限」。如果 Cloud Run 執行個體與Google Cloud API (例如 Cloud 用戶端程式庫) 介接，請參閱服務身分設定指南。 如要進一步瞭解如何授予角色，請參閱「部署權限」和「管理存取權」。

設定或修改標籤

您可以使用 Google Cloud CLI 設定或修改標籤：

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 會在執行個體物件上設定標籤，而 spec.template.metadata.labels 則會在建立的修訂版本上設定標籤。Cloud Run 只會將修訂版本上設定的標籤傳播至 Cloud Billing 和 Cloud Logging。

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