原文：https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/

你可以使用 Kubernetes 注解将任何非标识性元数据关联到对象上。使用客户端（如工具和库）可以检索到这些元数据。

关联元数据到对象

你可以使用标签或注解将元数据关联到 Kubernetes 对象上。标签可以用于选择对象和查找满足特定条件的对象集合。相反，注解不用于识别和选择对象。注解中的元数据可大可小、可结构化也可非结构化，并且可以包含标签不允许的字符。

annotation 和 label 一样都是 key/value 键值对映射结构：

  1. "metadata": {
  2.   "annotations": {
  3.     "key1" : "value1",
  4.     "key2" : "value2"
  5.   }
  6. }

以下列出了一些可以记录在 annotation 中的对象信息：

  • 声明配置层管理的字段。使用注解关联这类字段可以用于区分客户端或服务器设置的默认值、自动生成的字段以及自动调整大小或自动调整系统设置的字段。

  • 构建信息、版本信息或镜像信息。例如：时间戳、版本号、git 分支、PR 序号、镜像哈希值以及仓库地址。

  • 记录日志、监控、分析或审计存储仓库的指针。

  • 用于调试当客户端库或工具的信息。例如：名称、版本和构建信息。

  • 用户信息，以及工具或系统来源信息。例如：来自其他生态系统组件相关对象的 URL。

  • 轻量级部署工具元数据。例如：配置或检查点。

  • 负责人的电话或联系方式、能找到相关信息的目录条目信息（例如，团队网站）。

如果不使用注解，你也可以将以上类型的信息存放在外部数据库或目录中，但这样做不利于创建用于部署、管理、内部检查的共享工具和客户端库。