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 控制台、gcloud 命令行或 YAML 文件来设置或修改标签。
在 Google Cloud 控制台中,前往 Cloud Run:
选中要为其设置标签的服务左侧的复选框。
确保最右侧的“信息面板”已开启(显示信息面板)。
点击标签以显示标签窗格。
要修改现有标签键值对,请找到相应标签,然后根据需要更改值。
要为该服务设置新标签,请点击添加标签并提供键和值。
点击保存
您可以使用命令更新服务的标签:
gcloud run services updateSERVICE --update-labelsKEY =VALUE
要更新多个标签,请提供以英文逗号分隔的键值对列表。请注意,如果标签已存在,update-labels
命令会为标签键设置新值,否则它会创建新标签。
替换
- 将 SERVICE 替换为您的 Cloud Run 服务的名称
- 将 KEY 替换为您的标签键的名称
- 将 VALUE 替换为键的值
您还可以在部署期间设置标签:
gcloud run deploySERVICE --imageIMAGE --labelsKEY =VALUE
要在部署期间创建多个标签,请提供以英文逗号分隔的键值对列表。
如果您要创建新的服务,请跳过此步骤。如果您要更新现有服务,请下载其 YAML 配置:
gcloud run services describe
SERVICE --format export > service.yaml在两个位置更新
labels
特性:apiVersion: serving.knative.dev/v1 kind: Service metadata: name:
SERVICE labels:LABEL :VALUE spec: template: metadata: labels:LABEL :VALUE name:REVISION 替换
- 将 SERVICE 替换为您的 Cloud Run 服务的名称
- 将 LABEL 替换为标签的名称
- 将 VALUE 替换为所需的值
- 将 REVISION 替换为新的修订版本名称或者将其删除(如果存在)。如果您提供新的修订版本名称,则该名称必须满足以下条件:
- 开头为
SERVICE-
- 仅包含小写字母、数字和
-
- 不以
-
结尾 - 不超过 63 个字符
- 开头为
metadata.labels
用于对服务对象设置标签,spec.template.metadata.label
用于对创建的修订版本设置标签。只有对修订版本设置的标签会传递给日志和结算。使用以下命令创建或更新服务:
gcloud run services replace service.yaml
如需了解如何应用或移除 Terraform 配置,请参阅基本 Terraform 命令。
以下代码段为 Cloud Run 实例添加了两个标签:foo
(其值为 bar
)和 baz
(其值为 quux
),并使用 Terraform 配置中的 google_cloud_run_v2_service
资源。
如下所示,在 template
下添加标签会为修订版本设置标签:只有为修订版本设置的标签会传递给日志和结算。如果您向 template
以外的位置添加标签,则系统会为服务(而非修订版本)设置标签。
请替换以下内容
- 将
name
属性替换为您的服务名称。 - 将
location
属性替换为用于您的服务的位置。 - 将
image
属性替换为您的容器映像。 foo
和baz
替换为您自己的标签名称。bar
和quux
替换为您自己的标签值。
按标签列出服务
您可以使用 Google Cloud CLI 过滤条件按标签列出服务:
gcloud run services list --filter metadata.labels.LABEL =VALUE
您需要将其中的:
- 将 LABEL 替换为标签的名称
- 将 VALUE 替换为要包含在过滤列表中的值
在服务上删除标签
您可以使用控制台或命令行在服务上删除标签。
在 Google Cloud 控制台中,前往 Cloud Run:
选中要从中删除标签的服务左侧的复选框。
确保最右侧的“信息面板”已开启(显示信息面板)。
点击标签以显示标签窗格。
找到您要删除的标签。
将光标悬停在标签对应的“值”文本框的右侧,以显示垃圾箱图标,然后点击该图标。
点击保存
要清除服务的所有标签,请使用以下命令:
gcloud run services updateSERVICE --clear-labels
要删除服务的特定标签,请提供以英文逗号分隔的键列表:
gcloud run services updateSERVICE --remove-labelsLABEL
替换
- 将 SERVICE 替换为您的 Cloud Run 服务的名称
- 将 LABEL 替换为您的标签名称