应用自定义元数据（引擎） | Apply custom metadata (Engine)

Docker 对象标签

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

• 图片

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

标签键和值

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

重要格式建议

标签键是键值对的左侧。密钥是可能包含句点（.）和连字符（-）的字母数字字符串。大多数 Docker 用户使用由其他组织创建的图像，并且以下指导原则有助于防止跨对象无意间重复标签，特别是如果您打算将标签用作自动化机制。

• 第三方工具的作者应该为每个标签关键字加上他们拥有的域的反向DNS标记，例如com.example.some-label。

这些准则目前尚未实施，其他准则可能适用于特定用例。

价值准则

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

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

管理对象上的标签

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

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

• 图像和容器

Usage, user guide, labels, metadata, docker, documentation, examples, annotating