Docker对象标签

预计阅读时间:3分钟

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

  • 图片
  • 货柜
  • 本地守护程序
  • 卷数
  • 网路
  • 群体节点
  • 群服务

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

标签键和值

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

关键格式建议

标签键值对的左侧。键是字母数字字符串,可能包含句点(.)和连字符(-)。大多数Docker用户都使用其他组织创建的映像,并且以下准则有助于防止跨对象的标签意外复制,尤其是在您计划将标签用作自动化机制的情况下。

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

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

  • com.docker.*io.docker.*org.dockerproject.*命名空间是由泊坞窗供内部使用保留的。

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

  • 句点字符(.)分隔名称空间“字段”。不带名称空间的标签键保留供CLI使用,从而允许CLI的用户使用更短的键入友好字符串来交互式地标记Docker对象。

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

价值准则

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

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

管理对象上的标签

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

映像,容器,本地守护程序,卷和网络上的标签在对象的生存期内是静态的。要更改这些标签,必须重新创建对象。群节点和服务上的标签可以动态更新。

用法用户指南标签元数据泊坞窗文档示例注释