設定工作標籤

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 控制台或 Google Cloud CLI 設定標籤,Cloud Run 會將標籤新增至 metadata.labelsspec.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. 如要編輯現有標籤鍵值,請找出該標籤並變更「值」

  6. 如要在服務上設定新標籤,請按一下「新增標籤」,然後提供鍵和值。

  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_NAME --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 替換為所選值。

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

    Cloud Run 只會將 spec.template.metadata.labels 屬性中設定的標籤傳播至 Cloud Billing 和 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:所選值。

Cloud Run 只會將 template 下設定的標籤傳播至 Cloud Billing 和 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:標籤名稱