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