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 标记本地镜像0e5574283393
如fedora/httpd
带有标签version1.0
:
$ docker tag 0e5574283393 fedora/httpd:version1.0
标记 Name 引用的镜像
标记本地镜像httpd
如fedora/httpd
带有标签version1.0
:
$ docker tag httpd fedora/httpd:version1.0
请注意,由于未指定标签名称,因此会为
现有本地版本httpd:latest
.
标记 Name 和 Tag 引用的镜像
使用名称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