docker-pull - Online in the Cloud

PROGRAM:

NAME

docker-pull - Pull an image or a repository from a registry

SYNOPSIS

docker pull [-a|--all-tags] [--help] NAME[:TAG] |
[REGISTRY_HOST[:REGISTRY_PORT]/]NAME[:TAG]

DESCRIPTION

This command pulls down an image or a repository from a registry. If there is more than
one image for a repository (e.g., fedora) then all images for that repository name can be
pulled down including any tags (see the option -a or --all-tags).

If you do not specify a REGISTRY_HOST, the command uses Docker's public registry located
at registry-1.docker.io by default.

OPTIONS

-a, --all-tags=true|false
Download all tagged images in the repository. The default is false.

--help
Print usage statement

EXAMPLE

Pull a repository with multiple images with the -a|--all-tags option set to true.

Note that if the image is previously downloaded then the status would be Status: Image is
up to date for 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
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

Pull a repository with the -a|--all-tags option set to false (this is the default).

$ docker pull debian
Using default tag: latest
latest: Pulling from library/debian
2c49f83e0b13: Pull complete
4a5e6db8c069: Pull complete

Status: Downloaded newer image for debian:latest

$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
debian latest 4a5e6db8c069 5 days ago 125.1 MB

Pull an image, manually specifying path to Docker's public registry and tag

Note that if the image is previously downloaded then the status would be Status: Image is
up to date for registry.hub.docker.com/fedora:20

$ docker pull registry.hub.docker.com/fedora:20
Pulling repository fedora
3f2fed40e4b0: Download complete
511136ea3c5a: Download complete
fd241224e9cf: Download complete

Status: Downloaded newer image for registry.hub.docker.com/fedora:20

$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
fedora 20 3f2fed40e4b0 4 days ago 372.7 MB

HISTORY

April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on
docker.com source material and internal work. June 2014, updated by Sven Dowideit
⟨[email protected]⟩ August 2014, updated by Sven Dowideit
⟨[email protected]⟩ April 2015, updated by John Willis ⟨[email protected]⟩
April 2015, updated by Mary Anthony for v2 ⟨[email protected]⟩ September 2015, updated by
Sally O'Malley ⟨[email protected]⟩

Use docker-pull online using onworks.net services