設定工作標籤

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

可能的用途包括：

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

標籤使用規則

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

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

必要的角色

如要取得設定 Cloud Run 作業所需的權限，請要求管理員授予下列 IAM 角色：

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

設定或修改標籤

您可以使用 Google Cloud CLI、YAML 或 Terraform，為 Cloud Run 工作設定標籤。

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 改為所選值。

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

  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 改為所選值。

依標籤列出工作

您可以使用 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 改為標籤名稱