docker image tag

描述

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

[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，并使用标签 version1.0

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

标记通过名称引用的镜像

要将本地镜像 httpd 标记为 fedora/httpd，并使用标签 version1.0

$ docker tag httpd fedora/httpd:version1.0

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

标记通过名称和标签引用的镜像

要将名称为 httpd 且标签为 test 的本地镜像标记为 fedora/httpd，并使用标签 version1.0.test

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

标记私有注册表的镜像

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

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