pull¶

Usage: docker pull [OPTIONS] NAME[:TAG] | [REGISTRY_HOST[:REGISTRY_PORT]/]NAME[:TAG]

Pull an image or a repository from the registry

  -a, --all-tags=false          Download all tagged images in the repository
  --disable-content-trust=true  Skip image verification
  --help=false                  Print usage

大部分のイメージは、 Docker Hub レジストリにあるベース・イメージをもとに作られています。

Docker Hub には多くの構築済みのイメージがあり、 pull （取得）し、自分や定義や設定をしなくても試せることです。

また、手動でレジストリのパスを指定し、そこから取得することも可能です。例えば、ローカルにレジストリをセットアップしている場合、そのパスを指定して、そこから pull できます。レポジトリのパスは、 URL に似た形式ですが、プロトコルの指定は含みません（例： https:// ）。

特定のイメージやイメージの集まり（例：レポジトリ）をダウンロードするには、 docker pull を使います。

$ docker pull debian
# will pull the debian:latest image and its intermediate layers
$ docker pull debian:testing
# will pull the image named debian:testing and any intermediate
# layers it is based on.
$ docker pull debian@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf
# will pull the image from the debian repository with the digest
# sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf
# and any intermediate layers it is based on.
# (Typically the empty `scratch` image, a MAINTAINER layer,
# and the un-tarred base).
$ docker pull --all-tags centos
# will pull all the images from the centos repository
$ docker pull registry.hub.docker.com/debian
# manually specifies the path to the default Docker registry. This could
# be replaced with the path to a local registry to pull from another source.
# sudo docker pull myhub.com:8080/test-image