Docker 对象标签
标签是一种将元数据应用于 Docker 对象的机制,包括:
- 镜像
- 容器
- 本地守护进程
- 卷
- 网络
- Swarm 节点
- Swarm 服务
您可以使用标签来组织镜像、记录许可信息、注释容器、卷和网络之间的关系,或者以任何对您的业务或应用程序有意义的方式使用。
标签键和值
标签是一个键值对,以字符串形式存储。您可以为一个对象指定多个标签,但每个键在对象内必须是唯一的。如果同一个键被赋予了多个值,则最新写入的值将覆盖所有先前的值。
键格式建议
标签键是键值对的左侧部分。键是字母数字字符串,可以包含句点 (.)、下划线 (_)、斜杠 (/) 和连字符 (-)。大多数 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 节点和服务上的标签可以动态更新。