Docker object labels

预计阅读时间:3分钟

标签是一种将元数据应用于 Docker 对象的机制,包括:

  • Images
  • Containers
  • 本地守护进程
  • Volumes
  • Networks
  • 集群节点
  • 群服务

您可以使用标签来组织图像、记录许可信息、注释容器、卷和网络之间的关系,或者以任何对您的业务或应用程序有意义的方式.

Label keys and values

标签是键值对,存储为字符串. 您可以为一个对象指定多个标签,但每个键值对在一个对象中必须是唯一的. 如果给同一个键多个值,最近写入的值会覆盖所有以前的值.

Key format recommendations

标签是键值对的左侧. 键是字母数字字符串,可能包含句点 ( . ) 和连字符 ( - ). 大多数 Docker 用户使用由其他组织创建的映像,以下指南有助于防止无意中跨对象重复标签,尤其是在您计划使用标签作为自动化机制的情况下.

  • 第三方工具的作者应为每个标签键加上他们拥有的域的反向 DNS 表示法,例如com.example.some-label .

  • 未经域所有者许可,请勿在标签键中使用域.

  • com.docker.*io.docker.*org.dockerproject.*命名空间由 Docker 保留供内部使用.

  • 标签键应以小写字母开头和结尾,并且应仅包含小写字母数字字符、句点字符 ( . ) 和连字符 ( - ). 不允许使用连续的句点或连字符.

  • 句点字符 ( . ) 分隔命名空间"字段". 没有命名空间的标签键保留给 CLI 使用,允许 CLI 的用户使用更短的易于键入的字符串以交互方式标记 Docker 对象.

这些指南当前未强制执行,其他指南可能适用于特定用例.

Value guidelines

标签值可以包含任何可以表示为字符串的数据类型,包括(但不限于)JSON、XML、CSV 或 YAML. 唯一的要求是首先使用特定于结构类型的机制将值序列化为字符串. 例如,要将 JSON 序列化为字符串,您可以使用JSON.stringify() JavaScript 方法.

由于 Docker 不会反序列化该值,因此在按标签值查询或过滤时,您不能将 JSON 或 XML 文档视为嵌套结构,除非您将此功能构建到第三方工具中.

Manage labels on objects

支持标签的每种类型的对象都有添加和管理它们的机制,并在它们与该类型的对象相关时使用它们. 这些链接提供了一个开始学习如何在 Docker 部署中使用标签的好地方.

图像、容器、本地守护程序、卷和网络上的标签在对象的生命周期内是静态的. 要更改这些标签,您必须重新创建对象. swarm 节点和服务上的标签可以动态更新.

Usage, 用户指南, labels, metadata, docker, documentation, examples, annotating

by  icopy.site