Skip to content
This repository was archived by the owner on Oct 13, 2023. It is now read-only.

Commit f9159f9

Browse files
thaJeztahthaJeztah
committed
docs/deprecated: remove minor versions
Some deprecations are ammended during a major (YY.MM) release, to inform users as early as possible about deprecations. Removing the minor version from this overview clarifies that features are marked deprecated during which major release's lifecycle. Signed-off-by: Sebastiaan van Stijn <github@gone.nl> (cherry picked from commit de8b696ed6cabdfa6f02516f875f4ed056f65efa) Signed-off-by: Sebastiaan van Stijn <github@gone.nl> Upstream-commit: 20bc15f618d9650ecc4710ef3329bb4c89d94830 Component: cli
1 parent a7d8e5b commit f9159f9

1 file changed

Lines changed: 53 additions & 53 deletions

File tree

‎components/cli/docs/deprecated.md‎

Lines changed: 53 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -50,43 +50,43 @@ The table below provides an overview of the current status of deprecated feature
5050

5151
Status | Feature | Deprecated | Remove
5252
-----------|------------------------------------------------------------------------------------------------------------------------------------|------------|------------
53-
Deprecated | [Configuration options for experimental CLI features](#configuration-options-for-experimental-cli-features) | v19.03.0 | v20.03.0
54-
Deprecated | [Pushing and pulling with image manifest v2 schema 1](#pushing-and-pulling-with-image-manifest-v2-schema-1) | v19.03.0 | v20.03.0
55-
Deprecated | [`docker engine` subcommands](#docker-engine-subcommands) | v19.03.0 | v20.03.0
56-
Deprecated | [Top-level `docker deploy` subcommand (experimental)](#top-level-docker-deploy-subcommand-experimental) | v19.03.0 | v20.03.0
57-
Deprecated | [`docker stack deploy` using "dab" files (experimental)](#docker-stack-deploy-using-dab-files-experimental) | v19.03.0 | v20.03.0
58-
Deprecated | [AuFS storage driver](#aufs-storage-driver) | v19.03.0 | -
59-
Deprecated | [Legacy "overlay" storage driver](#legacy-overlay-storage-driver) | v18.09.0 | -
60-
Deprecated | [Device mapper storage driver](#device-mapper-storage-driver) | v18.09.0 | -
61-
Deprecated | [Reserved namespaces in engine labels](#reserved-namespaces-in-engine-labels) | v18.06.0 | v20.03.0
62-
Removed | [`--disable-legacy-registry` override daemon option](#--disable-legacy-registry-override-daemon-option) | v17.12.0 | v19.03.0
63-
Removed | [Interacting with V1 registries](#interacting-with-v1-registries) | v17.06.0 | v17.12.0
64-
Removed | [Asynchronous `service create` and `service update` as default](#asynchronous-service-create-and-service-update-as-default) | v17.05.0 | v17.10.0
65-
Removed | [`-g` and `--graph` flags on `dockerd`](#-g-and---graph-flags-on-dockerd) | v17.05.0 | -
66-
Deprecated | [Top-level network properties in NetworkSettings](#top-level-network-properties-in-networksettings) | v1.13.0 | v17.12.0
67-
Deprecated | [`filter` param for `/images/json` endpoint](#filter-param-for-imagesjson-endpoint) | v1.13.0 | v17.12.0
68-
Removed | [`repository:shortid` image references](#repositoryshortid-image-references) | v1.13.0 | v17.12.0
69-
Removed | [`docker daemon` subcommand](#docker-daemon-subcommand) | v1.13.0 | v17.12.0
70-
Removed | [Duplicate keys with conflicting values in engine labels](#duplicate-keys-with-conflicting-values-in-engine-labels) | v1.13.0 | v17.12.0
71-
Deprecated | [`MAINTAINER` in Dockerfile](#maintainer-in-dockerfile) | v1.13.0 | -
72-
Deprecated | [API calls without a version](#api-calls-without-a-version) | v1.13.0 | v17.12.0
73-
Removed | [Backing filesystem without `d_type` support for overlay/overlay2](#backing-filesystem-without-d_type-support-for-overlayoverlay2) | v1.13.0 | v17.12.0
74-
Deprecated | [`--automated` and `--stars` flags on `docker search`](#--automated-and---stars-flags-on-docker-search) | v1.12.0 | v17.09.0
75-
Deprecated | [`-h` shorthand for `--help`](#-h-shorthand-for---help) | v1.12.0 | v17.09.0
76-
Removed | [`-e` and `--email` flags on `docker login`](#-e-and---email-flags-on-docker-login) | v1.11.0 | v17.06.0
77-
Deprecated | [Separator (`:`) of `--security-opt` flag on `docker run`](#separator--of---security-opt-flag-on-docker-run) | v1.11.0 | v17.06.0
78-
Deprecated | [Ambiguous event fields in API](#ambiguous-event-fields-in-api) | v1.10.0 | -
79-
Removed | [`-f` flag on `docker tag`](#-f-flag-on-docker-tag) | v1.10.0 | v1.12.0
80-
Removed | [HostConfig at API container start](#hostconfig-at-api-container-start) | v1.10.0 | v1.12.0
81-
Removed | [`--before` and `--since` flags on `docker ps`](#--before-and---since-flags-on-docker-ps) | v1.10.0 | v1.12.0
82-
Removed | [Driver-specific log tags](#driver-specific-log-tags) | v1.9.0 | v1.12.0
83-
Removed | [Docker Content Trust `ENV` passphrase variables name change](#docker-content-trust-env-passphrase-variables-name-change) | v1.9.0 | v1.12.0
84-
Removed | [`/containers/(id or name)/copy` endpoint](#containersid-or-namecopy-endpoint) | v1.8.0 | v1.12.0
85-
Removed | [LXC built-in exec driver](#lxc-built-in-exec-driver) | v1.8.0 | v1.10.0
86-
Removed | [Old Command Line Options](#old-command-line-options) | v1.8.0 | v1.10.0
87-
Removed | [`--api-enable-cors` flag on `dockerd`](#--api-enable-cors-flag-on-dockerd) | v1.6.0 | v17.09.0
88-
Removed | [`--run` flag on `docker commit`](#--run-flag-on-docker-commit) | v0.10.0 | v1.13.0
89-
Removed | [Three arguments form in `docker import`](#three-arguments-form-in-docker-import) | v0.6.7 | v1.12.0
53+
Deprecated | [Configuration options for experimental CLI features](#configuration-options-for-experimental-cli-features) | v19.03 | v20.03
54+
Deprecated | [Pushing and pulling with image manifest v2 schema 1](#pushing-and-pulling-with-image-manifest-v2-schema-1) | v19.03 | v20.03
55+
Deprecated | [`docker engine` subcommands](#docker-engine-subcommands) | v19.03 | v20.03
56+
Deprecated | [Top-level `docker deploy` subcommand (experimental)](#top-level-docker-deploy-subcommand-experimental) | v19.03 | v20.03
57+
Deprecated | [`docker stack deploy` using "dab" files (experimental)](#docker-stack-deploy-using-dab-files-experimental) | v19.03 | v20.03
58+
Deprecated | [AuFS storage driver](#aufs-storage-driver) | v19.03 | -
59+
Deprecated | [Legacy "overlay" storage driver](#legacy-overlay-storage-driver) | v18.09 | -
60+
Deprecated | [Device mapper storage driver](#device-mapper-storage-driver) | v18.09 | -
61+
Deprecated | [Reserved namespaces in engine labels](#reserved-namespaces-in-engine-labels) | v18.06 | v20.03
62+
Removed | [`--disable-legacy-registry` override daemon option](#--disable-legacy-registry-override-daemon-option) | v17.12 | v19.03
63+
Removed | [Interacting with V1 registries](#interacting-with-v1-registries) | v17.06 | v17.12
64+
Removed | [Asynchronous `service create` and `service update` as default](#asynchronous-service-create-and-service-update-as-default) | v17.05 | v17.10
65+
Removed | [`-g` and `--graph` flags on `dockerd`](#-g-and---graph-flags-on-dockerd) | v17.05 | -
66+
Deprecated | [Top-level network properties in NetworkSettings](#top-level-network-properties-in-networksettings) | v1.13 | v17.12
67+
Deprecated | [`filter` param for `/images/json` endpoint](#filter-param-for-imagesjson-endpoint) | v1.13 | v17.12
68+
Removed | [`repository:shortid` image references](#repositoryshortid-image-references) | v1.13 | v17.12
69+
Removed | [`docker daemon` subcommand](#docker-daemon-subcommand) | v1.13 | v17.12
70+
Removed | [Duplicate keys with conflicting values in engine labels](#duplicate-keys-with-conflicting-values-in-engine-labels) | v1.13 | v17.12
71+
Deprecated | [`MAINTAINER` in Dockerfile](#maintainer-in-dockerfile) | v1.13 | -
72+
Deprecated | [API calls without a version](#api-calls-without-a-version) | v1.13 | v17.12
73+
Removed | [Backing filesystem without `d_type` support for overlay/overlay2](#backing-filesystem-without-d_type-support-for-overlayoverlay2) | v1.13 | v17.12
74+
Deprecated | [`--automated` and `--stars` flags on `docker search`](#--automated-and---stars-flags-on-docker-search) | v1.12 | v17.09
75+
Deprecated | [`-h` shorthand for `--help`](#-h-shorthand-for---help) | v1.12 | v17.09
76+
Removed | [`-e` and `--email` flags on `docker login`](#-e-and---email-flags-on-docker-login) | v1.11 | v17.06
77+
Deprecated | [Separator (`:`) of `--security-opt` flag on `docker run`](#separator--of---security-opt-flag-on-docker-run) | v1.11 | v17.06
78+
Deprecated | [Ambiguous event fields in API](#ambiguous-event-fields-in-api) | v1.10 | -
79+
Removed | [`-f` flag on `docker tag`](#-f-flag-on-docker-tag) | v1.10 | v1.12
80+
Removed | [HostConfig at API container start](#hostconfig-at-api-container-start) | v1.10 | v1.12
81+
Removed | [`--before` and `--since` flags on `docker ps`](#--before-and---since-flags-on-docker-ps) | v1.10 | v1.12
82+
Removed | [Driver-specific log tags](#driver-specific-log-tags) | v1.9 | v1.12
83+
Removed | [Docker Content Trust `ENV` passphrase variables name change](#docker-content-trust-env-passphrase-variables-name-change) | v1.9 | v1.12
84+
Removed | [`/containers/(id or name)/copy` endpoint](#containersid-or-namecopy-endpoint) | v1.8 | v1.12
85+
Removed | [LXC built-in exec driver](#lxc-built-in-exec-driver) | v1.8 | v1.10
86+
Removed | [Old Command Line Options](#old-command-line-options) | v1.8 | v1.10
87+
Removed | [`--api-enable-cors` flag on `dockerd`](#--api-enable-cors-flag-on-dockerd) | v1.6 | v17.09
88+
Removed | [`--run` flag on `docker commit`](#--run-flag-on-docker-commit) | v0.10 | v1.13
89+
Removed | [Three arguments form in `docker import`](#three-arguments-form-in-docker-import) | v0.6.7 | v1.12
9090

9191
### Configuration options for experimental CLI features
9292

@@ -96,9 +96,9 @@ enabled by default, and these configuration options will no longer be functional
9696

9797
### Pushing and pulling with image manifest v2 schema 1
9898

99-
**Deprecated in Release: v19.03.0**
99+
**Deprecated in Release: v19.03**
100100

101-
**Target For Removal In Release: v20.03.0**
101+
**Target For Removal In Release: v20.03**
102102

103103
The image manifest
104104
[v2 schema 1](https://github.com/docker/distribution/blob/fda42e5ef908bdba722d435ff1f330d40dfcd56c/docs/spec/manifest-v2-1.md)
@@ -110,9 +110,9 @@ If the registry you are using still supports v2 schema 1, urge their administrat
110110

111111
### `docker engine` subcommands
112112

113-
**Deprecated in Release: v19.03.0**
113+
**Deprecated in Release: v19.03**
114114

115-
**Target For Removal In Release: v20.03.0**
115+
**Target For Removal In Release: v20.03**
116116

117117
The `docker engine activate`, `docker engine check`, and `docker engine update`
118118
provided an alternative installation method to upgrade Docker Community engines
@@ -126,9 +126,9 @@ standard package managers.
126126

127127
### Top-level `docker deploy` subcommand (experimental)
128128

129-
**Deprecated in Release: v19.03.0**
129+
**Deprecated in Release: v19.03**
130130

131-
**Target For Removal In Release: v20.03.0**
131+
**Target For Removal In Release: v20.03**
132132

133133
The top-level `docker deploy` command (using the "Docker Application Bundle"
134134
(.dab) file format was introduced as an experimental feature in Docker 1.13 /
@@ -138,9 +138,9 @@ subcommand.
138138

139139
### `docker stack deploy` using "dab" files (experimental)
140140

141-
**Deprecated in Release: v19.03.0**
141+
**Deprecated in Release: v19.03**
142142

143-
**Target For Removal In Release: v20.03.0**
143+
**Target For Removal In Release: v20.03**
144144

145145
With no development being done on this feature, and no active use of the file
146146
format, support for the DAB file format and the top-level docker deploy command
@@ -150,7 +150,7 @@ using compose files.
150150

151151
### AuFS storage driver
152152

153-
**Deprecated in Release: v19.03.0**
153+
**Deprecated in Release: v19.03**
154154

155155
The `aufs` storage driver is deprecated in favor of `overlay2`, and will
156156
be removed in a future release. Users of the `aufs` storage driver are
@@ -169,7 +169,7 @@ maintenance of the `aufs` storage driver.
169169

170170
### Legacy "overlay" storage driver
171171

172-
**Deprecated in Release: v18.09.0**
172+
**Deprecated in Release: v18.09**
173173

174174
The `overlay` storage driver is deprecated in favor of the `overlay2` storage
175175
driver, which has all the benefits of `overlay`, without its limitations (excessive
@@ -184,7 +184,7 @@ backported), there is no reason to keep maintaining the `overlay` storage driver
184184

185185
### Device mapper storage driver
186186

187-
**Deprecated in Release: v18.09.0**
187+
**Deprecated in Release: v18.09**
188188

189189
The `devicemapper` storage driver is deprecated in favor of `overlay2`, and will
190190
be removed in a future release. Users of the `devicemapper` storage driver are
@@ -201,13 +201,13 @@ is no reason to continue maintenance of the `devicemapper` storage driver.
201201

202202
### Reserved namespaces in engine labels
203203

204-
**Deprecated in Release: v18.06.0**
204+
**Deprecated in Release: v18.06**
205205

206206
The namespaces `com.docker.*`, `io.docker.*`, and `org.dockerproject.*` in engine labels
207207
were always documented to be reserved, but there was never any enforcement.
208208

209209
Usage of these namespaces will now cause a warning in the engine logs to discourage their
210-
use, and will error instead in v20.03.0 and above.
210+
use, and will error instead in v20.03 and above.
211211

212212

213213
### `--disable-legacy-registry` override daemon option
@@ -243,11 +243,11 @@ start when set.
243243

244244
### Asynchronous `service create` and `service update` as default
245245

246-
**Deprecated In Release: v17.05.0**
246+
**Deprecated In Release: v17.05**
247247

248248
**Disabled by default in release: [v17.10](https://github.com/docker/docker-ce/releases/tag/v17.10.0-ce)**
249249

250-
Docker 17.05.0 added an optional `--detach=false` option to make the
250+
Docker 17.05 added an optional `--detach=false` option to make the
251251
`docker service create` and `docker service update` work synchronously. This
252252
option will be enabled by default in Docker 17.10, at which point the `--detach`
253253
flag can be used to use the previous (asynchronous) behavior.
@@ -257,7 +257,7 @@ and `docker service scale` in Docker 17.10.
257257

258258
### `-g` and `--graph` flags on `dockerd`
259259

260-
**Deprecated In Release: v17.05.0**
260+
**Deprecated In Release: v17.05**
261261

262262
The `-g` or `--graph` flag for the `dockerd` or `docker daemon` command was
263263
used to indicate the directory in which to store persistent data and resource

0 commit comments

Comments
 (0)