設定工作標籤

Cloud Run 標籤是套用至 Cloud Run 工作的鍵/值組合。本頁面說明如何設定、修改及刪除 Cloud Run 工作的標籤。

可能用途包括:

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

標籤使用規則

下列規則適用於 Cloud Run 工作設定的標籤:

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

帳單資料和記錄的標籤

Cloud Billing 只會接收 YAML 中 metadata.labels 屬性指定的標籤,或 Terraform 中頂層 labels 引數指定的標籤。Cloud Logging 只會接收 YAML 中 spec.template.metadata.labels 屬性或 Terraform 中 template 下指定的標籤。如要將標籤傳播至 Cloud Billing 和 Cloud Logging,請在使用 YAML 或 Terraform 時,在兩個位置都指定標籤。如果您使用 Google Cloud 控制台或 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 控制台、Google Cloud CLI、YAML 或 Terraform,為 Cloud Run 工作設定標籤。

控制台

  1. 前往 Google Cloud 控制台的 Cloud Run「Jobs」(工作) 頁面:

    前往 Cloud Run。

  2. 找出要設定標籤的工作,勾選左側的核取方塊。

  3. 確認最右側的「資訊面板」已開啟 (「顯示資訊面板」)。

  4. 按一下「標籤」,顯示標籤窗格。

    設定標籤

  5. 如要編輯現有的標籤鍵值,請找出標籤並變更「Value」(值)。

  6. 如要為服務設定新標籤,請按一下「Add Label」(新增標籤),然後提供鍵和值。

  7. 按一下「儲存」

gcloud

  1. 如要為新工作設定標籤:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE

    更改下列內容:

    • 將 JOB_NAME 替換成工作名稱。
    • 將 KEY 替換成標籤鍵名稱。
    • VALUE:鍵的值。
    • IMAGE_URL:容器映像檔的參照,例如 us-docker.pkg.dev/cloudrun/container/job:latest。
  2. 如要為現有工作設定標籤,請按照下列步驟操作:

    gcloud run jobs update JOB_NAME --labels KEY=VALUE
  3. 如要建立多個標籤,請提供以半形逗號分隔的鍵/值組合清單。

    gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2 

YAML

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

    gcloud run jobs describe JOB --format export > job.yaml
  2. 在兩個位置更新 labels 屬性:

    apiVersion: run.googleapis.com/v1
    kind: Job
    metadata:
      labels:
        LABEL: VALUE
    spec:
      template:
        metadata:
          labels:
            LABEL: VALUE

    更改下列內容:

    • LABEL:標籤名稱。
    • VALUE 則會顯示所選值。

    您也可以指定更多設定,例如環境變數或記憶體限制。

    metadata.labels 會在工作物件上設定標籤,而 spec.template.metadata.labels 則會在執行範本上設定標籤。Cloud Run 會將 metadata.labels 中設定的標籤傳播至 Cloud Billing,並將 spec.template.metadata.labels 中設定的標籤傳播至 Cloud Logging。

  3. 更新現有工作設定:

    gcloud run jobs replace job.yaml

Terraform

如要瞭解如何套用或移除 Terraform 設定,請參閱「基本 Terraform 指令」。

在 Terraform 設定中,將下列內容新增至 google_cloud_run_v2_job 資源:

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "REGION"

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
      }
    }
    labels = {
    "LABEL":"VALUE"
    }
  }
  labels = {
    "LABEL":"VALUE"
  }
}

更改下列內容:

  • JOB_NAME:Cloud Run 工作名稱。
  • REGION: Google Cloud 區域。例如:europe-west1。
  • LABEL:標籤名稱。
  • VALUE:所選值。

頂層 labels 引數會設定工作的標籤,而 template 下方的 labels 引數則會設定執行範本的標籤。Cloud Run 會將頂層 labels 傳播至 Cloud Billing,並將 template 下設定的 labels 傳播至 Cloud Logging。

依標籤列出工作

您可以使用 Google Cloud CLI 篩選器,依標籤列出工作:

  gcloud run jobs list --filter metadata.labels.LABEL=VALUE
  

更改下列內容:

  • LABEL:標籤名稱
  • VALUE:要納入篩選清單的值

刪除工作的標籤

如要清除工作的所有標籤,請按照下列步驟操作:

gcloud run jobs update JOB --clear-labels

如要從服務中刪除特定標籤,請提供以半形逗號分隔的鍵清單:

gcloud run jobs update JOB --remove-labels LABEL

更改下列內容:

  • JOB:Cloud Run 工作名稱
  • LABEL:標籤名稱