本页面介绍了如何在 Cloud Run 工作器池上设置自定义说明。说明是附加到工作器池的人类可读的可选文本。
说明的长度不得超过 512 个字符。如果存在说明,则使用 gcloud beta run worker-pools describe
查看工作器池的详细信息时会显示说明。
所需的角色
如需获得配置和部署 Cloud Run 工作器池所需的权限,请让您的管理员为您授予以下 IAM 角色:
-
Cloud Run 工作器池的 Cloud Run Developer (
roles/run.developer
) 角色 -
服务身份的 Service Account User (
roles/iam.serviceAccountUser
) 角色
如需查看与 Cloud Run 关联的 IAM 角色和权限的列表,请参阅 Cloud Run IAM 角色和 Cloud Run IAM 权限。如果您的 Cloud Run 工作器池与Google Cloud API(例如 Cloud 客户端库)进行交互,请参阅服务身份配置指南。如需详细了解如何授予角色,请参阅部署权限和管理访问权限。
设置或修改说明
在创建新工作器池时,使用 Google Cloud CLI 为 Cloud Run 工作器池设置说明:
gcloud
您可以在部署期间设置或更新说明:
gcloud beta run worker-pools deploy WORKER_POOL --description DESCRIPTION
替换以下内容:
- WORKER_POOL:Cloud Run 工作器池的名称
- 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 工作器池的名称
- 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: Google Cloud 区域,例如 europe-west1
- IMAGE_URL:对包含工作器池的容器映像的引用,例如
us-docker.pkg.dev/cloudrun/container/worker-pool:latest
- DESCRIPTION:工作器池的说明