Skip to content

Commit de8b696

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 <[email protected]>
1 parent 4882256 commit de8b696

1 file changed

Lines changed: 63 additions & 63 deletions

File tree

‎docs/deprecated.md‎

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

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

9696
### Kernel memory limit
9797

98-
**Deprecated in Release: v20.03.0**
98+
**Deprecated in Release: v20.03**
9999

100100
Specifying kernel memory limit (`docker run --kernel-memory`) is now marked as deprecated,
101101
as [Linux kernel deprecated `kmem.limit_in_bytes` in v5.4](https://github.com/torvalds/linux/commit/0158115f702b0ba208ab0b5adf44cae99b3ebcc7).
102102

103103
### Classic Swarm and overlay networks using cluster store
104104

105-
**Deprecated in Release: v20.03.0**
105+
**Deprecated in Release: v20.03**
106106

107107
Standalone ("classic") Swarm has been deprecated, and with that the use of overlay
108108
networks using an external key/value store. The corresponding`--cluster-advertise`,
@@ -112,7 +112,7 @@ deprecated, and will be disabled or removed in a future release.
112112

113113
### Support for legacy `~/.dockercfg` configuration files
114114

115-
**Deprecated in Release: v20.03.0**
115+
**Deprecated in Release: v20.03**
116116

117117
The docker CLI up until v1.7.0 used the `~/.dockercfg` file to store credentials
118118
after authenticating to a registry (`docker login`). Docker v1.7.0 replaced this
@@ -133,13 +133,13 @@ enabled by default, and these configuration options will no longer be functional
133133

134134
### CLI plugins support
135135

136-
**Deprecated in Release: v20.03.0**
136+
**Deprecated in Release: v20.03**
137137

138138
CLI Plugin API is now marked as deprecated.
139139

140140
### Dockerfile legacy `ENV name value` syntax
141141

142-
**Deprecated in Release: v20.03.0**
142+
**Deprecated in Release: v20.03**
143143

144144
The Dockerfile `ENV` instruction allows values to be set using either `ENV name=value`
145145
or `ENV name value`. The latter (`ENV name value`) form can be ambiguous, for example,
@@ -163,9 +163,9 @@ ENV ONE="" TWO="" THREE="world"
163163

164164
### Pushing and pulling with image manifest v2 schema 1
165165

166-
**Deprecated in Release: v19.03.0**
166+
**Deprecated in Release: v19.03**
167167

168-
**Target For Removal In Release: v20.03.0**
168+
**Target For Removal In Release: v20.03**
169169

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

178178
### `docker engine` subcommands
179179

180-
**Deprecated in Release: v19.03.0**
180+
**Deprecated in Release: v19.03**
181181

182-
**Removed in Release: v20.03.0**
182+
**Removed in Release: v20.03**
183183

184184
The `docker engine activate`, `docker engine check`, and `docker engine update`
185185
provided an alternative installation method to upgrade Docker Community engines
@@ -193,9 +193,9 @@ standard package managers.
193193

194194
### Top-level `docker deploy` subcommand (experimental)
195195

196-
**Deprecated in Release: v19.03.0**
196+
**Deprecated in Release: v19.03**
197197

198-
**Removed in Release: v20.03.0**
198+
**Removed in Release: v20.03**
199199

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

206206
### `docker stack deploy` using "dab" files (experimental)
207207

208-
**Deprecated in Release: v19.03.0**
208+
**Deprecated in Release: v19.03**
209209

210-
**Removed in Release: v20.03.0**
210+
**Removed in Release: v20.03**
211211

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

218218
### AuFS storage driver
219219

220-
**Deprecated in Release: v19.03.0**
220+
**Deprecated in Release: v19.03**
221221

222222
The `aufs` storage driver is deprecated in favor of `overlay2`, and will
223223
be removed in a future release. Users of the `aufs` storage driver are
@@ -236,7 +236,7 @@ maintenance of the `aufs` storage driver.
236236

237237
### Legacy "overlay" storage driver
238238

239-
**Deprecated in Release: v18.09.0**
239+
**Deprecated in Release: v18.09**
240240

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

252252
### Device mapper storage driver
253253

254-
**Deprecated in Release: v18.09.0**
254+
**Deprecated in Release: v18.09**
255255

256256
The `devicemapper` storage driver is deprecated in favor of `overlay2`, and will
257257
be removed in a future release. Users of the `devicemapper` storage driver are
@@ -268,15 +268,15 @@ is no reason to continue maintenance of the `devicemapper` storage driver.
268268

269269
### Use of reserved namespaces in engine labels
270270

271-
**Deprecated in Release: v18.06.0**
271+
**Deprecated in Release: v18.06**
272272

273273
**Removed In Release: v20.03**
274274

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

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

281281

282282
### `--disable-legacy-registry` override daemon option
@@ -312,11 +312,11 @@ start when set.
312312

313313
### Asynchronous `service create` and `service update` as default
314314

315-
**Deprecated In Release: v17.05.0**
315+
**Deprecated In Release: v17.05**
316316

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

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

327327
### `-g` and `--graph` flags on `dockerd`
328328

329-
**Deprecated In Release: v17.05.0**
329+
**Deprecated In Release: v17.05**
330330

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

0 commit comments

Comments
 (0)