配置标签

Cloud Run 标签是应用于 Cloud Run 服务和修订版本的键值对。本页介绍如何设置、修改和删除 Cloud Run 服务和修订版本上的标签。请注意，在 Cloud Run 服务上设置标签时，系统会为此服务创建带有该标签的新修订版本；该标签不会应用于先前的修订版本。

可能的用途包括：

用于费用分配和账单明细。
确定各个团队或费用中心使用的资源。
区分部署环境（生产、预演、质量检查或测试）。
识别所有者、状态标签。
在 Logging 中过滤日志。

标签使用规则

以下规则适用于使用在 Cloud Run 服务上设置的标签：

只允许在 Cloud Run 上使用有效的 Google Cloud 标签。

设置或修改标签

任何配置更改都会导致新修订版本的创建。后续修订版本也将自动采用此配置设置，除非您进行了明确更新。

您可以在部署新修订版本时使用 Google Cloud 控制台、gcloud 命令行或 YAML 文件来设置或修改标签。

控制台

在 Google Cloud 控制台中，前往 Cloud Run：

转到 Cloud Run
选中要为其设置标签的服务左侧的复选框。
确保最右侧的“信息面板”已开启（显示信息面板）。
点击标签以显示标签窗格。
要修改现有标签键值对，请找到相应标签，然后根据需要更改值。
要为该服务设置新标签，请点击添加标签并提供键和值。
点击保存。

命令行

您可以使用命令更新服务的标签：

gcloud run services update SERVICE --update-labels KEY=VALUE

要更新多个标签，请提供以英文逗号分隔的键值对列表。请注意，如果标签已存在，update-labels 命令会为标签键设置新值，否则它会创建新标签。

替换

将 SERVICE 替换为您的 Cloud Run 服务的名称
将 KEY 替换为您的标签键的名称
将 VALUE 替换为键的值

您还可以在部署期间设置标签：

gcloud run deploy SERVICE --image IMAGE --labels KEY=VALUE

要在部署期间创建多个标签，请提供以英文逗号分隔的键值对列表。

YAML

您可以使用 gcloud run services describe --format export 命令下载并查看现有服务配置，该命令会生成清理后的 YAML 格式的结果。然后按照后续说明修改字段，最后使用 gcloud run services replace 命令上传修改后的 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 配置，请参阅基本 Terraform 命令。

以下代码段为 Cloud Run 实例添加了两个标签：foo（其值为 bar）和 baz（其值为 quux)，并使用 Terraform 配置中的 google_cloud_run_v2_service 资源。

如下所示，在 template 下添加标签会为修订版本设置标签：只有为修订版本设置的标签会传递给日志和结算。如果您向 template 以外的位置添加标签，则系统会为服务（而非修订版本）设置标签。

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-labels"
  location = "us-central1"

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    # Labels
    labels = {
      foo : "bar"
      baz : "quux"
    }
  }
}

请替换以下内容

将 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：

转到 Cloud Run
选中要从中删除标签的服务左侧的复选框。
确保最右侧的“信息面板”已开启（显示信息面板）。
点击标签以显示标签窗格。
找到您要删除的标签。
将光标悬停在标签对应的“值”文本框的右侧，以显示垃圾箱图标，然后点击该图标。
点击保存。

命令行

要清除服务的所有标签，请使用以下命令：

gcloud run services update SERVICE --clear-labels

要删除服务的特定标签，请提供以英文逗号分隔的键列表：

gcloud run services update SERVICE --remove-labels LABEL

替换

将 SERVICE 替换为您的 Cloud Run 服务的名称
将 LABEL 替换为您的标签名称