4.4 资源注解

除了标签(label)之外,Pod 与其他各种资源还能使用资源注解(annotation)。与标签类似,注解也是“键值”类型的数据,不过它不能用于标签及挑选 Kubernetes 对象,仅可用于为资源提供“元数据”信息。另外,注解中的元数据不受字符数量的限制,它可大可小,可以为结构化或非结构化形式,也支持使用在标签中禁止使用的其他字段。

资源注解可由用户手动添加,也可由工具程序自动附加并使用它们。在 kubernetes 的新版本中(alpha 或 beta 阶段)为某资源引入新字段时,常以注解的方式提供,以避免其增删等变动对用户带来困扰,一旦确定支持使用它们,这些新增字段就将再引入到资源中并淘汰相关的注解,另外,为资源添加注解也可以让其他用户快速了解资源的相关信息,例如其创建者的身份等。以下为常用的场景案例。

  • 由声明式配置层(如 apply 命令)管理的字段:将这些字段定义的注解有助于识别由服务器或客户端设定的默认值、系统自动生成的字段以及由自动伸缩系统生成的字段。
  • 构建、发行或镜像相关的信息,例如,时间戳、发行ID、Git分支、PR号码、镜像哈希及仓库地址等。
  • 指向日志、监控、分析或审计仓库的指针。
  • 由客户端库或工具程序生成的用于调试目的的信息:如名称、版本、构建信息等。
  • 用户或工具程序的来源地信息,例如,来自其他生态系统组件的相关对象的url。
  • 轻量化滚动升级工具的元数据,如 config 及 checkpoints。
  • 相关人员的电话号码等联系信息,或者指向类似信息的可寻址的目录条目,如网站站点。

results matching ""

    No results matching ""