Skip to content

Commit 7c0824c

Browse files
silvin-lubeckisilvin-lubecki
authored
Merge pull request #2776 from thaJeztah/19.03_backport_deprecate_experimental_options
[19.03 backport] Deprecate configuration options for experimental CLI features
2 parents 11b255c + 20bc15f commit 7c0824c

File tree

2 files changed

+61
-53
lines changed

2 files changed

+61
-53
lines changed

‎docs/deprecated.md‎

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

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

9197
### Pushing and pulling with image manifest v2 schema 1
9298

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

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

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

105111
### `docker engine` subcommands
106112

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

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

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

121127
### Top-level `docker deploy` subcommand (experimental)
122128

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

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

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

133139
### `docker stack deploy` using "dab" files (experimental)
134140

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

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

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

145151
### AuFS storage driver
146152

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

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

164170
### Legacy "overlay" storage driver
165171

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

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

179185
### Device mapper storage driver
180186

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

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

196202
### Reserved namespaces in engine labels
197203

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

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

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

206212

207213
### `--disable-legacy-registry` override daemon option
@@ -237,11 +243,11 @@ start when set.
237243

238244
### Asynchronous `service create` and `service update` as default
239245

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

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

244-
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
245251
`docker service create` and `docker service update` work synchronously. This
246252
option will be enabled by default in Docker 17.10, at which point the `--detach`
247253
flag can be used to use the previous (asynchronous) behavior.
@@ -251,7 +257,7 @@ and `docker service scale` in Docker 17.10.
251257

252258
### `-g` and `--graph` flags on `dockerd`
253259

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

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

‎docs/reference/commandline/cli.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22
title: "Use the Docker command line"
33
description: "Docker's CLI command description and usage"
44
keywords: "Docker, Docker documentation, CLI, command line"
5+
redirect_from:
6+
- /go/experimental/
57
---
68

79
<!-- This file is maintained within the docker/cli GitHub

0 commit comments

Comments
 (0)