docker image push
描述 | 将镜像上传到注册表 |
---|---|
用法 | docker image push [OPTIONS] NAME[:TAG] |
别名 | docker push |
描述
使用docker image push
将您的镜像共享到Docker Hub 注册表或自托管注册表。
有关有效镜像和标签名称的更多信息,请参阅docker image tag
参考。
例如,在终端运行时按CTRL-c
终止docker image push
进程,将终止推送操作。
在 docker push 期间会显示进度条,显示未压缩的大小。实际推送的数据量将在发送前进行压缩,因此上传大小不会反映在进度条中。
注册表凭据由docker login管理。
并发上传
默认情况下,Docker 守护程序一次将推送镜像的五个层。如果您使用的是低带宽连接,这可能会导致超时问题,您可能需要通过--max-concurrent-uploads
守护程序选项降低此值。有关更多详细信息,请参阅守护程序文档。
选项
选项 | 默认值 | 描述 |
---|---|---|
-a, --all-tags | 将镜像的所有标签推送到存储库 | |
--disable-content-trust | true | 跳过镜像签名 |
--platform | API 1.46+ 将特定于平台的清单作为单平台镜像推送到注册表。 不会推送镜像索引,这意味着其他清单(包括证明)不会保留。 'os[/arch[/variant]]': 显式平台(例如 linux/amd64) | |
-q, --quiet | 抑制详细输出 |
示例
将新镜像推送到注册表
首先通过查找容器 ID(使用docker container ls
)并将容器提交到新的镜像名称来保存新镜像。请注意,命名镜像时只允许使用a-z0-9-_.
$ docker container commit c16378f943fe rhel-httpd:latest
现在,使用镜像 ID 将镜像推送到注册表。在此示例中,注册表位于名为registry-host
的主机上,并侦听端口5000
。为此,请使用主机名或 IP 地址以及注册表的端口标记镜像
$ docker image tag rhel-httpd:latest registry-host:5000/myadmin/rhel-httpd:latest
$ docker image push registry-host:5000/myadmin/rhel-httpd:latest
运行以下命令检查是否成功
$ docker image ls
您应该会看到列出的rhel-httpd
和registry-host:5000/myadmin/rhel-httpd
。
推送镜像的所有标签 (-a, --all-tags)
使用-a
(或--all-tags
)选项推送本地镜像的所有标签。
以下示例为镜像创建多个标签,并将所有这些标签推送到 Docker Hub。
$ docker image tag myimage registry-host:5000/myname/myimage:latest
$ docker image tag myimage registry-host:5000/myname/myimage:v1.0.1
$ docker image tag myimage registry-host:5000/myname/myimage:v1.0
$ docker image tag myimage registry-host:5000/myname/myimage:v1
镜像现在已使用多个名称进行标记
$ docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
myimage latest 6d5fcfe5ff17 2 hours ago 1.22MB
registry-host:5000/myname/myimage latest 6d5fcfe5ff17 2 hours ago 1.22MB
registry-host:5000/myname/myimage v1 6d5fcfe5ff17 2 hours ago 1.22MB
registry-host:5000/myname/myimage v1.0 6d5fcfe5ff17 2 hours ago 1.22MB
registry-host:5000/myname/myimage v1.0.1 6d5fcfe5ff17 2 hours ago 1.22MB
使用--all-tags
选项推送时,将推送registry-host:5000/myname/myimage
镜像的所有标签
$ docker image push --all-tags registry-host:5000/myname/myimage
The push refers to repository [registry-host:5000/myname/myimage]
195be5f8be1d: Pushed
latest: digest: sha256:edafc0a0fb057813850d1ba44014914ca02d671ae247107ca70c94db686e7de6 size: 4527
195be5f8be1d: Layer already exists
v1: digest: sha256:edafc0a0fb057813850d1ba44014914ca02d671ae247107ca70c94db686e7de6 size: 4527
195be5f8be1d: Layer already exists
v1.0: digest: sha256:edafc0a0fb057813850d1ba44014914ca02d671ae247107ca70c94db686e7de6 size: 4527
195be5f8be1d: Layer already exists
v1.0.1: digest: sha256:edafc0a0fb057813850d1ba44014914ca02d671ae247107ca70c94db686e7de6 size: 4527