Browse code

Merge pull request #15760 from mikebrow/9235-improve-documentation

Improvement to userguide/dockerrepos/ documentation

Sebastiaan van Stijn authored on 2015/08/27 08:21:12
Showing 1 changed files
... ...
@@ -53,9 +53,9 @@ interface or by using the command line interface. Searching can find images by i
53 53
 name, user name, or description:
54 54
 
55 55
     $ docker search centos
56
-    NAME           DESCRIPTION                                     STARS     OFFICIAL   TRUSTED
57
-    centos         Official CentOS 6 Image as of 12 April 2014     88
58
-    tianon/centos  CentOS 5 and 6, created using rinse instea...   21
56
+    NAME           DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
57
+    centos         The official build of CentOS                    1223      [OK]
58
+    tianon/centos  CentOS 5 and 6, created using rinse instea...   33
59 59
     ...
60 60
 
61 61
 There you can see two example results: `centos` and `tianon/centos`. The second
... ...
@@ -68,16 +68,28 @@ a user's repository from the image name.
68 68
 Once you've found the image you want, you can download it with `docker pull <imagename>`:
69 69
 
70 70
     $ docker pull centos
71
-    Pulling repository centos
72
-    0b443ba03958: Download complete
73
-    539c0211cd76: Download complete
74
-    511136ea3c5a: Download complete
75
-    7064731afe90: Download complete
76
-
77
-    Status: Downloaded newer image for centos
71
+    Using default tag: latest
72
+    latest: Pulling from library/centos
73
+    f1b10cd84249: Pull complete
74
+    c852f6d61e65: Pull complete
75
+    7322fbe74aa5: Pull complete
76
+    Digest: sha256:90305c9112250c7e3746425477f1c4ef112b03b4abe78c612e092037bfecc3b7
77
+    Status: Downloaded newer image for centos:latest
78 78
 
79 79
 You now have an image from which you can run containers.
80 80
 
81
+### Specific Versions or Latest
82
+Using `docker pull centos` is equivalent to using `docker pull centos:latest`.
83
+To pull an image that is not the default latest image you can be more precise
84
+with the image that you want.
85
+
86
+For example, to pull version 5 of `centos` use `docker pull centos:centos5`.
87
+In this example, `centos5` is the tag labeling an image in the `centos`
88
+repository for a version of `centos`.
89
+
90
+To find a list of tags pointing to currently available versions of a repository
91
+see the [Docker Hub](https://hub.docker.com) registry.
92
+
81 93
 ## Contributing to Docker Hub
82 94
 
83 95
 Anyone can pull public images from the [Docker Hub](https://hub.docker.com)