Cloud Run 标签是应用于 Cloud Run 工作器池的键值对。本页面介绍了如何在 Cloud Run 工作器池上设置、修改和删除标签。请注意,在 Cloud Run 工作器池上设置标签时,系统会为此工作器池创建一个具有此标签的新修订版本;该标签不会应用于先前的修订版本。
可能的用途包括:
- 费用分配和账单明细。
- 确定各个团队或费用中心使用的资源。
- 区分部署环境(生产、预演、质量检查或测试)。
- 识别所有者和状态标签。
- 在 Logging 中过滤日志。
标签使用规则
以下规则适用于使用在 Cloud Run 工作器池上设置的标签:
只能在 Cloud Run 上使用有效 Google Cloud 标签。
所需的角色
如需获得配置和部署 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 控制台、Google Cloud CLI 或 Terraform 设置或修改标签:
控制台
在 Google Cloud 控制台中,前往 Cloud Run:
找到相应工作器池,然后选中其名称左侧的复选框。
点击标签以显示标签窗格。
要修改现有标签键值对,请找到相应标签,然后根据需要更改值。
如需在工作器池上设置新标签,请点击添加标签,然后提供键和值。
点击保存
gcloud
您可以使用以下命令更新工作器池的标签:
gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE
如需更新多个标签,请提供以英文逗号分隔的键值对列表。请注意,如果标签已存在,update-labels
命令会为标签键设置新值,否则它会创建新标签。
替换以下内容:
- WORKER_POOL:Cloud Run 工作器池的名称
- 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 删除工作器池上的标签。
控制台
在 Google Cloud 控制台中,前往 Cloud Run:
找到相应工作器池,然后选中其名称左侧的复选框。
点击标签以显示标签窗格。
找到您要删除的标签。
将光标悬停在标签的值文本框的右侧,以显示回收站图标,然后点击该图标。
点击保存
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 工作器池的名称
- LABEL:标签的名称