設定工作站集區的標籤

Cloud Run 標籤是套用至 Cloud Run worker 集區的鍵/值組合。本頁說明如何設定、修改及刪除 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 控制台、Google Cloud CLI 或 Terraform 設定或修改標籤：

控制台

  1. 前往 Google Cloud 控制台的 Cloud Run：

    前往 Cloud Run

  2. 找出工作站集區，然後選取名稱左側的核取方塊。

  3. 按一下「標籤」，顯示「標籤」窗格。

    設定標籤

  4. 如要編輯現有標籤鍵值，請找出標籤並視需要變更「值」。

  5. 如要在工作者集區中設定新標籤，請按一下「新增標籤」，然後提供鍵和值。

  6. 點選「儲存」。

gcloud

您可以使用下列指令更新工作站集區的標籤：

gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE

如要更新多個標籤，請提供以逗號分隔的鍵/值組合清單。請注意，如果標籤已存在，update-labels 指令會為標籤鍵設定新值，否則會建立新標籤。

更改下列內容：

  • WORKER_POOL：Cloud Run worker 集區的名稱
  • KEY：標籤鍵的名稱
  • VALUE：鍵的值

您也可以在部署期間設定標籤：

gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE

如要在部署期間建立多個標籤，請提供以半形逗號分隔的鍵/值組合清單。

Terraform

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

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"
  launch_stage = "BETA"

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
  labels = {
    KEY : "VALUE"
  }
}

更改下列內容：

  • WORKER_POOL：工作站集區的名稱
  • REGION：區域，例如 Google Cloud europe-west1
  • IMAGE_URL：參照包含工作站集區的容器映像檔，例如 us-docker.pkg.dev/cloudrun/container/worker-pool:latest
  • KEY：標籤鍵的名稱
  • VALUE：鍵的值

依標籤列出服務

您可以使用 Google Cloud CLI 篩選器，依標籤列出服務：

  gcloud beta run worker-pools list --filter metadata.labels.LABEL=VALUE

更改下列內容：

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

刪除工作站集區的標籤

您可以使用 Google Cloud 控制台或 Google Cloud CLI 刪除 worker 集區的標籤。

控制台

  1. 前往 Google Cloud 控制台的 Cloud Run：

    前往 Cloud Run

  2. 找出工作站集區，然後選取名稱左側的核取方塊。

  3. 按一下「標籤」，顯示「標籤」窗格。

    設定標籤

  4. 找出要刪除的標籤。

  5. 將游標懸停在標籤「值」文字方塊右側，顯示垃圾桶圖示，然後按一下該圖示。

  6. 點選「儲存」。

gcloud

如要清除工作站集區的所有標籤，請執行下列步驟：

gcloud beta run worker-pools update WORKER_POOL --clear-labels

如要從工作站集區刪除特定標籤，請提供以半形逗號分隔的鍵清單：

gcloud beta run worker-pools update WORKER_POOL --remove-labels LABEL

更改下列內容：

  • WORKER_POOL：Cloud Run worker 集區的名稱
  • LABEL：標籤名稱