标签是一种将元数据应用于 Docker 对象的机制,包括:
图片
容器
本地守护进程
卷
网络
集群节点
集群服务
您可以使用标签来组织您的图像、记录许可信息、注释容器、卷和网络之间的关系,或者以对您的业务或应用程序有意义的任何方式。
标签键和值
标签是一个键值对,存储为字符串。您可以为一个对象指定多个标签,但每个键值对在一个对象中必须是唯一的。如果同一个键被赋予多个值,则最近写入的值会覆盖所有先前的值。
关键格式推荐
标签键是键值对的左侧。键是字母数字字符串,可能包含句点 ( .) 和连字符 ( -)。大多数 Docker 用户使用由其他组织创建的映像,以下准则有助于防止无意中跨对象复制标签,尤其是在您计划将标签用作自动化机制的情况下。
第三方工具的作者应该使用他们拥有的域的反向 DNS 符号作为每个标签键的前缀,例如com.example.some-label.
未经域所有者许可,请勿在标签密钥中使用域。
com.docker.*,io.docker.*和org.dockerproject.*命名空间是由docker供内部使用保留的。
标签键应以小写字母开头和结尾,并且应仅包含小写字母数字字符、句点字符 ( .) 和连字符 ( -)。不允许使用连续句号或连字符。
句点字符 ( .) 分隔命名空间“字段”。没有命名空间的标签键保留供 CLI 使用,允许 CLI 用户使用较短的键入友好字符串交互式标记 Docker 对象。
这些指南目前并未强制执行,其他指南可能适用于特定用例。