将注释和标签与 Cloud Deploy 搭配使用

您可以将注释和标签附加到 Cloud Deploy 资源。 它们不是强制要求。

本文档列出了可以附加标签和注释的资源，并说明了如何使用它们以及可在何处查看它们。

注释和标签简介

注释是包含自由格式文本的键值对。您可以使用它们来附加与资源关联的任意信息。

您可以使用标签来组织资源。例如，您可以根据标签选择来应用逻辑。

与注释一样，标签也是键值对。但它们必须符合以下限制：

  • Cloud Deploy 资源最多可以有 64 个标签。

  • 键和值不得超过 128 个字节。

  • 键和值只能包含小写字母、数字字符、下划线和短划线。

  • 键必须以小写字母或国际字符开头。

  • 所有字符必须使用 UTF-8 编码。允许使用国际字符。允许使用国际字符。

--labels 标志（例如，在 gcloud deploy releases create 上）可以接受键值对列表：

"name=wrench,mass=1.3kg,count=3"

如需了解详情，请参阅 Cloud Deploy API 文档 。

向 Cloud Deploy 资源添加注释和标签

您可以向以下 Cloud Deploy 资源添加注释和标签：

  • 交付流水线

    对于交付流水线，您可以向 YAML 配置文件添加注释和标签。

apiVersion: deploy.cloud.google.com/v1
  kind: DeliveryPipeline
  metadata:
   name:
   annotations:
     key: "value"
   labels:
     key: "value"
  description:
  serialPipeline:
   stages:
   - targetId:
     profiles: []
   - targetId:
     profiles: []

  • 目标

    在目标配置 YAML 中向目标添加注释和标签。

    例如，您可以添加指向应用的第三方监控的详细信息链接。但是，如果共享了目标，请记住，它可能会用于多个应用，因此链接不应该是特定于应用的。

  • 版本

    您可以在 gcloud deploy releases create 命令上使用 --labels 和 --annotations 标志向版本添加注释和/或标签。您添加到版本的标签和注释转入到产生的发布中的标签或注释。

    例如，您可以使用注释来包括对以下项目的引用：包含要部署的更改的 Git 提交的 Git PR、作者或 SHA 哈希。如需了解详情，请参阅使用注释来跟踪版本的来源。

  • 发布

    您可以通过在 gcloud deploy releases promote 命令上指定 --labels 或 --annotations 来向新发布添加注释和标签。

    您可以通过在