1. docker
  2. Commit 20dd2d1e4e2ae80dfcfb241d5027e55942f251bb
Browse code

Update `images` cli reference with reference filter

Signed-off-by: Vincent Demeester <vincent@sbr.pm>
(cherry picked from commit a0d7b34d9cb0876f8583a6e15d1b1aaab8d2b9ab)
Signed-off-by: Victor Vieux <victorvieux@gmail.com>

Vincent Demeester authored on 2016/11/17 23:34:17
Showing 2 changed files
docs/reference/api/docker_remote_api.md
History View file @ 20dd2d1
... ... 
@@ -194,6 +194,7 @@ This section lists each version from latest to oldest.  Each listing includes a
194 194 
 * `POST /plugins/create?name=(plugin name)` create a plugin.
195 195 
 * `DELETE /plugins/(plugin name)` delete a plugin.
196 196 
 * `POST /node/(id or name)/update` now accepts both `id` or `name` to identify the node to update.
197 
+* `GET /images/json` now support a `reference` filter.
197 198
198 199
199 200 
 ### v1.24 API changes
docs/reference/commandline/images.md
History View file @ 20dd2d1
... ... 
@@ -28,6 +28,7 @@ Options:
28 28 
                         - label=<key> or label=<key>=<value>
29 29 
                         - before=(<image-name>[:tag]|<image-id>|<image@digest>)
30 30 
                         - since=(<image-name>[:tag]|<image-id>|<image@digest>)
31 
+                        - reference=(pattern of an image reference)
31 32 
       --format string   Pretty-print images using a Go template
32 33 
       --help            Print usage
33 34 
       --no-trunc        Don't truncate output
... ... 
@@ -229,6 +230,24 @@ Filtering with `since` would give:
229 229 
     image1              latest              eeae25ada2aa        4 minutes ago        188.3 MB
230 230 
     image2              latest              dea752e4e117        9 minutes ago        188.3 MB
231 231
232 
+#### Reference
233 
+
234 
+The `reference` filter shows only images whose reference matches
235 
+the specified pattern.
236 
+
237 
+    $ docker images
238 
+    REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
239 
+    busybox             latest              e02e811dd08f        5 weeks ago         1.09 MB
240 
+    busybox             uclibc              e02e811dd08f        5 weeks ago         1.09 MB
241 
+    busybox             musl                733eb3059dce        5 weeks ago         1.21 MB
242 
+    busybox             glibc               21c16b6787c6        5 weeks ago         4.19 MB
243 
+
244 
+Filtering with `reference` would give:
245 
+
246 
+    $ docker images --filter=reference='busy*:*libc'
247 
+    REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
248 
+    busybox             uclibc              e02e811dd08f        5 weeks ago         1.09 MB
249 
+    busybox             glibc               21c16b6787c6        5 weeks ago         4.19 MB
232 250
233 251 
 ## Formatting
234 252