Add reference filter and deprecated filter param…

… for `docker images`.

This deprecates the `filter` param for the `/images` endpoint and make a
new filter called `reference` to replace it. It does change the CLI
side (still possible to do `docker images busybox:musl`) but changes the
cli code to use the filter instead (so that `docker images --filter
busybox:musl` and `docker images busybox:musl` act the same).

Signed-off-by: Vincent Demeester <vincent@sbr.pm>
This commit is contained in:
Vincent Demeester 2016-11-11 15:34:01 +01:00 committed by Tibor Vass
parent b70107a951
commit e17ee80404
1 changed files with 9 additions and 3 deletions

View File

@ -20,23 +20,29 @@ The following list of features are deprecated in Engine.
To learn more about Docker Engine's deprecation policy, To learn more about Docker Engine's deprecation policy,
see [Feature Deprecation Policy](https://docs.docker.com/engine/#feature-deprecation-policy). see [Feature Deprecation Policy](https://docs.docker.com/engine/#feature-deprecation-policy).
## `filter` param for `/images/json` endpoint
**Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/tag/v1.13.0)**
**Target For Removal In Release: v1.16**
The `filter` param to filter the list of image by reference (name or name:tag) is now implemented as a regular filter, named `reference`.
### `repository:shortid` image references ### `repository:shortid` image references
**Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/)** **Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/tag/v1.13.0)**
**Target For Removal In Release: v1.16** **Target For Removal In Release: v1.16**
`repository:shortid` syntax for referencing images is very little used, collides with with tag references can be confused with digest references. `repository:shortid` syntax for referencing images is very little used, collides with with tag references can be confused with digest references.
### `docker daemon` subcommand ### `docker daemon` subcommand
**Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/)** **Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/tag/v1.13.0)**
**Target For Removal In Release: v1.16** **Target For Removal In Release: v1.16**
The daemon is moved to a separate binary (`dockerd`), and should be used instead. The daemon is moved to a separate binary (`dockerd`), and should be used instead.
### Duplicate keys with conflicting values in engine labels ### Duplicate keys with conflicting values in engine labels
**Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/)** **Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/tag/v1.13.0)**
**Target For Removal In Release: v1.16** **Target For Removal In Release: v1.16**