docker pull

1. docker pull

1.1. 描述

docker pull 从镜像仓库拉取镜像到本地。

如果没有指定镜像标签，docker 默认使用当前最新的 tag 标记 :latest

使用的大多数镜像都是基于 Docker Hub 上的基础镜像制作的。

Docker Hub 上包含许多预先构建好的镜像，你可以下载并使用它们，而不需要自己去定义和配置镜像。

docker pull 的镜像如果不是公共开放的，还需要使用 docker login 提供认证信息。

默认 docker 使用 https:// 的方式访问镜像仓库，如果不是，需要在 /etc/docker/daemon.json 中添加配置 insecure registries 。

代理配置

如果您的项目处于一些企业服务器中，您可能需要使用环境变量：HTTP_PROXY, HTTPS_PROXY, and NO_PROXY 设置 Docker 守护进程的服务代理。可以通过 systemd 来设置这些环境变量，参考：systemd config

并行下载

默认情况下，Docker 守护程序将一次下载三层镜像。如果您的带宽比较低，可能会导致超时问题。您可以通过选项 --max-concurrent-downloads 来提高下载速度。

1.2. 帮助

$ docker pull --help

Usage: docker pull [OPTIONS] NAME[:TAG|@DIGEST]

Pull an image or a repository from a registry

Options:
  -a, --all-tags Download all tagged images in the repository
      --disable-content-trust Skip image verification (default true)
      --platform string Set platform if server is multi-platform capable

1.3. 选项

选项	描述
--all-tags, -a	下载一个仓库中所有镜像 tag 。即下载一个镜像的所有版本。
--disable-content-trust true	跳过镜像校验
--platform	设置镜像所属平台

1.4. 示例

拉取一个或多个镜像使用 docker pull，如果没有指定镜像标签，docker 默认使用当前最新的 tag 标记 :latest，下面的示例命令就会拉取最新的镜像文件，等同于：docker pull debian:latest

$ docker pull debian

Using default tag: latest
latest: Pulling from library/debian
fdd5d7827f33: Pull complete
a3ed95caeb02: Pull complete
Digest: sha256:e7d38b3517548a1c71e41bffe9c8ae6d6d29546ce46bf62159837aad072c90aa
Status: Downloaded newer image for debian:latest

docker 镜像基本都是由多层组成（分层存储），上面的镜像文件就是由两层构成：fdd5d7827f33 和 a3ed95caeb02.

每一层都可以被不同镜像共同使用，例如下面这个镜像 debian:jessie 就是与上述 debian:latest 共用两个相同的镜像层。在拉取 debian:jessie 的时候只会拉取其自身的一些元数据信息，而不会再去拉取镜像分层信息，因为在本地已经存在了这两个镜像层。

$ docker pull debian:jessie

jessie: Pulling from library/debian
fdd5d7827f33: Already exists
a3ed95caeb02: Already exists
Digest: sha256:a9c958be96d7d40df920e7041608f2f017af81800ca5ad23e327bc402626b58e
Status: Downloaded newer image for debian:jessie

要查看本地存在哪些图像，使用 docker images 命令：

$ docker images

REPOSITORY   TAG      IMAGE ID        CREATED      SIZE
debian       jessie   f50f9524513f    5 days ago   125.1 MB
debian       latest   f50f9524513f    5 days ago   125.1 MB

Docker 使用 内容寻址图像存储，并且图像 ID 是 SHA256 摘要值，覆盖了图像的配置和层。在上面的示例中， debian:jessie 和 debian:latest 具有相同的图像 ID，因为它们实际上是用不同名称标记的同一图像。因为它们是同一映像，所以它们的层仅存储一次，并且不占用额外的磁盘空间。

1.5. 通过sha256数字摘要拉取镜像

可以使用镜像名称（和 tag ）提取了图像，使用名称和标签是一种便捷方法。使用标签时，您可以再次docker pull 镜像以确保您具有该图像的最新版本。例如，docker pull ubuntu:14.04 提取最新版本的Ubuntu 14.04映像。

在某些情况下，您不希望将图像更新为较新的版本，而是希望使用镜像的固定版本。Docker允许按其摘要提取映像。当按摘要下载镜像时，需要明确指定要下载的镜像版本。这样做可以将镜像“固定”到该版本，并确保所使用的图像始终相同。

要了解镜像的 sha256 摘要，可以先下载镜像。

从 Docker Hub 中获取最新的 ubuntu:14.04 镜像：

$ docker pull ubuntu:14.04

14.04: Pulling from library/ubuntu
5a132a7e7af1: Pull complete
fd2731e4c50c: Pull complete
28a2f68d1120: Pull complete
a3ed95caeb02: Pull complete
Digest: sha256:45b23dee08af5e43a7fea6c4cf9c25ccf269ee113168c19722f87876677c5cb2
Status: Downloaded newer image for ubuntu:14.04

Docker下载完成后会显示出摘要，上面这个示例的摘要就是

sha256:45b23dee08af5e43a7fea6c4cf9c25ccf269ee113168c19722f87876677c5cb2

下载镜像时也可以使用摘要进行下载

$ docker pull ubuntu@sha256:45b23dee08af5e43a7fea6c4cf9c25ccf269ee113168c19722f87876677c5cb2

sha256:45b23dee08af5e43a7fea6c4cf9c25ccf269ee113168c19722f87876677c5cb2: Pulling from library/ubuntu
5a132a7e7af1: Already exists
fd2731e4c50c: Already exists
28a2f68d1120: Already exists
a3ed95caeb02: Already exists
Digest: sha256:45b23dee08af5e43a7fea6c4cf9c25ccf269ee113168c19722f87876677c5cb2
Status: Downloaded newer image for ubuntu@sha256:45b23dee08af5e43a7fea6c4cf9c25ccf269ee113168c19722f87876677c5cb2

摘要也可以在 Dockerfile 中使用，例如：

FROM ubuntu@sha256:45b23dee08af5e43a7fea6c4cf9c25ccf269ee113168c19722f87876677c5cb2
MAINTAINER some maintainer <maintainer@example.com>

1.5.1. 重其他镜像仓库拉取镜像

默认情况 docker pull 是从 Docker Hub 镜像仓库下载镜像，也可以使用一个其他的镜像仓库。例如，从 myregistry.local:5000 下载镜像

$ docker pull myregistry.local:5000/testing/test-image

1.5.2. 下载镜像的多个 tag

默认情况下，docker pull 只会下载一个仓库中的一个镜像版本。如果有需要，可以使用参数 -a 或 --all-tags 下载镜像的所有的版本。

例如，下载一个 fedora 的所有镜像

$ docker pull --all-tags fedora

Pulling repository fedora
ad57ef8d78d7: Download complete
105182bb5e8b: Download complete
511136ea3c5a: Download complete
73bd853d2ea5: Download complete
....

Status: Downloaded newer image for fedora

镜像下载完成后，可以使用 docker images 命令查看镜像。

$ docker images fedora

REPOSITORY TAG IMAGE ID CREATED SIZE
fedora rawhide ad57ef8d78d7 5 days ago 359.3 MB
fedora 20 105182bb5e8b 5 days ago 372.7 MB
fedora heisenbug 105182bb5e8b 5 days ago 372.7 MB
fedora latest 105182bb5e8b 5 days ago 372.7 MB

1.5.3. 终止下载

终止 docker pull 的过程，可以使用 CTRL-c 快捷键。

$ docker pull fedora

Using default tag: latest
latest: Pulling from library/fedora
a3ed95caeb02: Pulling fs layer
236608c7b546: Pulling fs layer
^C

从技术上讲，当 Docker Engine 守护程序与发起该拉取的 Docker Engine 客户端之间的连接丢失时，引擎会终止拉取操作。如果与 Engine 守护程序的连接由于手动交互以外的其他原因而丢失，则拉取操作也会中止。

docker pull