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 工作的 Cloud Run 開發人員 (
roles/run.developer) - 服務身分的服務帳戶使用者 (
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」(工作) 頁面:
找出要設定標籤的工作,勾選左側的核取方塊。
確認最右側的「資訊面板」已開啟 (「顯示資訊面板」)。
按一下「標籤」,顯示標籤窗格。
如要編輯現有的標籤鍵值,請找出標籤並變更「Value」(值)。
如要為服務設定新標籤,請按一下「Add Label」(新增標籤),然後提供鍵和值。
按一下「儲存」
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 --format export > job.yaml
在兩個位置更新
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。更新現有工作設定:
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:標籤名稱