1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00

Updated CLI documentation for docker pull with notes on specifying URL

Docker-DCO-1.1-Signed-off-by: Matthew Heon <mheon@redhat.com> (github: mheon)
This commit is contained in:
Matthew Heon 2014-06-09 11:27:08 -04:00
parent aab9078ff9
commit 03ae463c8d

View file

@ -735,7 +735,7 @@ Running `docker ps` showing 2 linked containers.
## pull ## pull
Usage: docker pull NAME[:TAG] Usage: docker pull [REGISTRY_PATH/]NAME[:TAG]
Pull an image or a repository from the registry Pull an image or a repository from the registry
@ -745,6 +745,11 @@ Most of your images will be created on top of a base image from the
[Docker Hub](https://hub.docker.com) contains many pre-built images that you [Docker Hub](https://hub.docker.com) contains many pre-built images that you
can `pull` and try without needing to define and configure your own. can `pull` and try without needing to define and configure your own.
It is also possible to manually specify the path of a registry to pull from.
For example, if you have set up a local registry, you can specify its path to
pull from it. A repository path is similar to a URL, but does not contain
a protocol specifier (https://, for example).
To download a particular image, or set of images (i.e., a repository), To download a particular image, or set of images (i.e., a repository),
use `docker pull`: use `docker pull`:
@ -752,8 +757,11 @@ use `docker pull`:
# will pull all the images in the debian repository # will pull all the images in the debian repository
$ docker pull debian:testing $ docker pull debian:testing
# will pull only the image named debian:testing and any intermediate layers # will pull only the image named debian:testing and any intermediate layers
# it is based on. (typically the empty `scratch` image, a MAINTAINERs layer, # it is based on. (Typically the empty `scratch` image, a MAINTAINERs layer,
# and the un-tared base. # and the un-tarred base).
$ 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.
## push ## push