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部署中使用标签的好地方。

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

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