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.labels 和 spec.template.metadata.labels 屬性。
必要的角色
如要取得設定 Cloud Run 作業所需的權限,請要求管理員授予您下列 IAM 角色:
- Cloud Run 開發人員 (
roles/run.developer) 在 Cloud Run 工作上 - 服務身分上的服務帳戶使用者 (
roles/iam.serviceAccountUser)
如需與 Cloud Run 相關聯的 IAM 角色和權限清單,請參閱「Cloud Run IAM 角色」和「Cloud Run IAM 權限」。如果 Cloud Run 作業與Google Cloud API (例如 Cloud 用戶端程式庫) 介接,請參閱服務身分設定指南。如要進一步瞭解如何授予角色,請參閱「部署權限」和「管理存取權」。
設定或修改標籤
您可以使用 Google Cloud 控制台、Google Cloud CLI、YAML 或 Terraform,在 Cloud Run 作業上設定標籤。
控制台
前往 Google Cloud 控制台的 Cloud Run「Jobs」頁面:
勾選要設定標籤的工作左側的核取方塊。
確認最右側的「資訊面板」已開啟 (「顯示資訊面板」)。
按一下「標籤」即可顯示標籤窗格。
如要編輯現有標籤鍵值,請找出該標籤並變更「值」。
如要在服務上設定新標籤,請按一下「新增標籤」,然後提供鍵和值。
按一下「儲存」。
gcloud
如要為新工作設定標籤,請按照下列步驟操作:
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。
如要為現有工作設定標籤:
gcloud run jobs update JOB_NAME --labels KEY=VALUE
如要建立多個標籤,請提供以半形逗號分隔的鍵/值組合清單。
gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2
YAML
如要建立新工作,請略過這個步驟。 如要更新現有工作,請下載其 YAML 設定:
gcloud run jobs describe JOB_NAME --format export > job.yaml
在兩個位置更新
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。更新現有工作設定:
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:標籤名稱