docker image push
| 描述 | 将镜像上传到注册表 |
|---|---|
| 用法 | docker image push [OPTIONS] NAME[:TAG] |
| 别名 | docker push |
描述
使用 docker image push 将您的镜像分享到 Docker Hub 注册表或自托管注册表。
有关有效镜像和标签名称的更多信息,请参阅 docker image tag 参考。
终止 docker image push 进程,例如在终端中运行时按下 CTRL-c,将终止推送操作。
在 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