Docker 对象标签

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

  • 图片
  • 集装箱
  • 本地守护进程
  • 卷
  • 网络
  • 集群节点
  • 集群服务

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

标签键和值

标签是一个键值对，存储为字符串。您可以为一个对象指定多个标签，但每个键在对象内必须是唯一的。如果同一键被赋予多个值，则最近写入的值将覆盖所有先前的值。

关键格式建议

标签键是键值对的左侧。键是字母数字字符串，可能包含句点 ( .) 和连字符 ( -)。大多数 Docker 用户使用其他组织创建的映像，以下准则有助于防止对象之间无意中重复标签，特别是如果您计划使用标签作为自动化机制。

  • 第三方工具的作者应在每个标签密钥前添加他们拥有的域的反向 DNS 表示法的前缀，例如com.example.some-label.

  • 未经域所有者许可，请勿在标签密钥中使用域。

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

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

  • 句点字符 ( .) 分隔命名空间“字段”。没有命名空间的标签键保留供 CLI 使用，允许 CLI 用户使用较短的适合打字的字符串以交互方式标记 Docker 对象。

这些准则目前尚未强制执行，其他准则可能适用于特定用例。

价值准则

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

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

管理对象上的标签

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

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