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 节点和服务上的标签可以动态更新。