Merge pull request #28477 from vdemeester/update-reference-filter-cli-reference

Update `images` cli reference with reference filter
This commit is contained in:
Sebastiaan van Stijn 2016-11-18 01:34:48 +01:00 committed by GitHub
commit c6d69ea9e9
2 changed files with 20 additions and 0 deletions

View file

@ -200,6 +200,7 @@ This section lists each version from latest to oldest. Each listing includes a
* `POST /plugins/create?name=(plugin name)` create a plugin.
* `DELETE /plugins/(plugin name)` delete a plugin.
* `POST /node/(id or name)/update` now accepts both `id` or `name` to identify the node to update.
* `GET /images/json` now support a `reference` filter.
### v1.24 API changes

View file

@ -28,6 +28,7 @@ Options:
- label=<key> or label=<key>=<value>
- before=(<image-name>[:tag]|<image-id>|<image@digest>)
- since=(<image-name>[:tag]|<image-id>|<image@digest>)
- reference=(pattern of an image reference)
--format string Pretty-print images using a Go template
--help Print usage
--no-trunc Don't truncate output
@ -229,6 +230,24 @@ Filtering with `since` would give:
image1 latest eeae25ada2aa 4 minutes ago 188.3 MB
image2 latest dea752e4e117 9 minutes ago 188.3 MB
#### Reference
The `reference` filter shows only images whose reference matches
the specified pattern.
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
busybox latest e02e811dd08f 5 weeks ago 1.09 MB
busybox uclibc e02e811dd08f 5 weeks ago 1.09 MB
busybox musl 733eb3059dce 5 weeks ago 1.21 MB
busybox glibc 21c16b6787c6 5 weeks ago 4.19 MB
Filtering with `reference` would give:
$ docker images --filter=reference='busy*:*libc'
REPOSITORY TAG IMAGE ID CREATED SIZE
busybox uclibc e02e811dd08f 5 weeks ago 1.09 MB
busybox glibc 21c16b6787c6 5 weeks ago 4.19 MB
## Formatting