泊坞窗图像标签

描述

完整的图像名称具有以下格式和组成部分：

[HOST[:PORT_NUMBER]/]PATH

• HOST：可选的注册表主机名指定映像所在的位置。主机名必须符合标准 DNS 规则，但不得包含下划线。如果不指定主机名，该命令默认使用 Docker 的公共注册表registry-1.docker.io。请注意，这docker.io是 Docker 公共注册表的规范参考。
• PORT_NUMBER：如果存在主机名，则可以选择在其后面跟随格式为 的注册表端口号:8080。
• PATH：路径由斜杠分隔的组件组成。每个组件可以包含小写字母、数字和分隔符。分隔符定义为一个句点、一个或两个下划线、或者一个或多个连字符。组件不能以分隔符开始或结束。虽然 OCI 分发规范 支持两个以上斜杠分隔的组件，但大多数注册表仅支持两个斜杠分隔的组件。对于Docker的公共注册表，路径格式如下：
  • [NAMESPACE/]REPOSITORY：第一个可选组件通常是用户或组织的名称空间。第二个强制组件是存储库名称。当命名空间不存在时，Docker 使用library 默认命名空间。

在图像名称之后，可选的TAG是一个自定义的、人类可读的清单标识符，通常是图像的特定版本或变体。该标签必须是有效的 ASCII，并且可以包含小写和大写字母、数字、下划线、句点和连字符。它不能以句点或连字符开头，且不得超过 128 个字符。如果您不指定标签，该命令将latest默认使用。

您可以使用名称和标签将图像分组在一起，然后 将它们推送到注册表。

例子

标记由 ID 引用的图像

要使用 ID 标记本地图像，0e5574283393就像fedora/httpd使用 tag 一样version1.0：

$ docker tag 0e5574283393 fedora/httpd:version1.0

标记按名称引用的图像

要使用 tag 标记httpd本地图像：fedora/httpdversion1.0

$ docker tag httpd fedora/httpd:version1.0

请注意，由于未指定标记名称，因此会为现有本地版本创建别名httpd:latest。

标记名称和标签引用的图像

要使用名称httpd和标签来标记本地图像test，就像fedora/httpd 使用 tag一样version1.0.test：

$ docker tag httpd:test fedora/httpd:version1.0.test

为私人注册表标记图像

要将映像推送到私有注册表而不是公共 Docker 注册表，您必须包含注册表主机名和端口（如果需要）。

$ docker tag 0e5574283393 myregistryhost:5000/fedora/httpd:version1.0