docker 镜像标签

描述创建引用 SOURCE_IMAGE 的标签TARGET_IMAGE
用法docker image tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]
别名
docker tag

描述

完整的镜像名称具有以下格式和组件:

[HOST[:PORT_NUMBER]/]PATH

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

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

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

例子

标记 ID 引用的镜像

使用 ID 标记本地镜像0e5574283393fedora/httpd带有标签version1.0:

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

标记 Name 引用的镜像

标记本地镜像httpdfedora/httpd带有标签version1.0:

$ docker tag httpd fedora/httpd:version1.0

请注意,由于未指定标签名称,因此会为 现有本地版本httpd:latest.

标记 Name 和 Tag 引用的镜像

使用名称httpd和标签testfedora/httpd带有标签version1.0.test:

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

为私有注册表标记镜像

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

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