本頁說明如何為 Cloud Run 工作站集區設定自訂說明。說明是附加至工作者集區的選用文字,方便使用者閱讀。
說明長度上限為 512 個半形字元。如有說明,使用 gcloud beta run worker-pools describe 查看工作站集區詳細資料時,系統會顯示說明。
必要的角色
如要取得設定及部署 Cloud Run worker 集區所需的權限,請要求管理員授予下列 IAM 角色:
-
Cloud Run 開發人員 (
roles/run.developer) 在 Cloud Run worker 集區上 -
服務帳戶使用者 (
roles/iam.serviceAccountUser) 服務身分
如需與 Cloud Run 相關聯的 IAM 角色和權限清單,請參閱「Cloud Run IAM 角色」和「Cloud Run IAM 權限」。如果 Cloud Run 工作站集區與Google Cloud API (例如 Cloud 用戶端程式庫) 介接,請參閱服務身分設定指南。如要進一步瞭解如何授予角色,請參閱「部署權限」和「管理存取權」。
設定或修改說明
使用 Google Cloud CLI 建立新的 worker 集區時,請為 Cloud Run worker 集區設定說明:
gcloud
您可以在部署期間設定或更新說明:
gcloud beta run worker-pools deploy WORKER_POOL --description DESCRIPTION
更改下列內容:
- WORKER_POOL:Cloud Run worker 集區的名稱
- DESCRIPTION:工作站集區的說明
YAML
如要建立新的工作站集區,請略過這個步驟。 如要更新現有工作站集區,請下載其 YAML 設定:
gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml
以下範例包含 YAML 設定:
apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL annotations: run.googleapis.com/launch-stage: BETA run.googleapis.com/description: DESCRIPTION
更改下列內容:
- WORKER_POOL:Cloud Run worker 集區的名稱
- DESCRIPTION:工作站集區的說明
使用下列指令建立或更新工作站集區:
gcloud beta run worker-pools replace workerpool.yaml
Terraform
如要瞭解如何套用或移除 Terraform 設定,請參閱「基本 Terraform 指令」。
resource "google_cloud_run_v2_worker_pool" "default" {
name = "WORKER_POOL"
location = "REGION"
launch_stage = "BETA"
template {
containers {
image = "IMAGE_URL"
}
}
description = "DESCRIPTION"
}
更改下列內容:
- WORKER_POOL:工作站集區的名稱
- REGION:區域,例如 europe-west1 Google Cloud
- IMAGE_URL:包含工作站集區的容器映像檔參照,例如
us-docker.pkg.dev/cloudrun/container/worker-pool:latest - DESCRIPTION:工作站集區的說明