github.com/AliyunContainerService/cli@v0.0.0-20181009023821-814ced4b30d0/docs/deprecated.md (about) 1 --- 2 aliases: ["/engine/misc/deprecated/"] 3 description: "Deprecated Features." 4 keywords: "docker, documentation, about, technology, deprecate" 5 --- 6 7 <!-- This file is maintained within the docker/cli GitHub 8 repository at https://github.com/docker/cli/. Make all 9 pull requests against that repo. If you see this file in 10 another repository, consider it read-only there, as it will 11 periodically be overwritten by the definitive file. Pull 12 requests which include edits to this file in other repositories 13 will be rejected. 14 --> 15 16 # Deprecated Engine Features 17 18 The following list of features are deprecated in Engine. 19 To learn more about Docker Engine's deprecation policy, 20 see [Feature Deprecation Policy](https://docs.docker.com/engine/#feature-deprecation-policy). 21 22 ### Reserved namespaces in engine labels 23 24 **Deprecated in Release: v18.06.0** 25 26 The namespaces `com.docker.*`, `io.docker.*`, and `org.dockerproject.*` in engine labels 27 were always documented to be reserved, but there was never any enforcement. 28 29 Usage of these namespaces will now cause a warning in the engine logs to discourage their 30 use, and will error instead in 18.12 and above. 31 32 ### Asynchronous `service create` and `service update` 33 34 **Deprecated In Release: v17.05.0** 35 36 **Disabled by default in release: [v17.10](https://github.com/docker/docker-ce/releases/tag/v17.10.0-ce)** 37 38 Docker 17.05.0 added an optional `--detach=false` option to make the 39 `docker service create` and `docker service update` work synchronously. This 40 option will be enabled by default in Docker 17.10, at which point the `--detach` 41 flag can be used to use the previous (asynchronous) behavior. 42 43 The default for this option will also be changed accordingly for `docker service rollback` 44 and `docker service scale` in Docker 17.10. 45 46 ### `-g` and `--graph` flags on `dockerd` 47 48 **Deprecated In Release: v17.05.0** 49 50 The `-g` or `--graph` flag for the `dockerd` or `docker daemon` command was 51 used to indicate the directory in which to store persistent data and resource 52 configuration and has been replaced with the more descriptive `--data-root` 53 flag. 54 55 These flags were added before Docker 1.0, so will not be _removed_, only 56 _hidden_, to discourage their use. 57 58 ### Top-level network properties in NetworkSettings 59 60 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 61 62 **Target For Removal In Release: v17.12** 63 64 When inspecting a container, `NetworkSettings` contains top-level information 65 about the default ("bridge") network; 66 67 `EndpointID`, `Gateway`, `GlobalIPv6Address`, `GlobalIPv6PrefixLen`, `IPAddress`, 68 `IPPrefixLen`, `IPv6Gateway`, and `MacAddress`. 69 70 These properties are deprecated in favor of per-network properties in 71 `NetworkSettings.Networks`. These properties were already "deprecated" in 72 docker 1.9, but kept around for backward compatibility. 73 74 Refer to [#17538](https://github.com/docker/docker/pull/17538) for further 75 information. 76 77 ### `filter` param for `/images/json` endpoint 78 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 79 80 **Target For Removal In Release: v17.12** 81 82 The `filter` param to filter the list of image by reference (name or name:tag) is now implemented as a regular filter, named `reference`. 83 84 ### `repository:shortid` image references 85 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 86 87 **Removed In Release: v17.12** 88 89 The `repository:shortid` syntax for referencing images is very little used, 90 collides with tag references, and can be confused with digest references. 91 92 Support for the `repository:shortid` notation to reference images was removed 93 in Docker 17.12. 94 95 ### `docker daemon` subcommand 96 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 97 98 **Removed In Release: v17.12** 99 100 The daemon is moved to a separate binary (`dockerd`), and should be used instead. 101 102 ### Duplicate keys with conflicting values in engine labels 103 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 104 105 **Removed In Release: v17.12** 106 107 When setting duplicate keys with conflicting values, an error will be produced, and the daemon 108 will fail to start. 109 110 ### `MAINTAINER` in Dockerfile 111 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 112 113 `MAINTAINER` was an early very limited form of `LABEL` which should be used instead. 114 115 ### API calls without a version 116 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 117 118 **Target For Removal In Release: v17.12** 119 120 API versions should be supplied to all API calls to ensure compatibility with 121 future Engine versions. Instead of just requesting, for example, the URL 122 `/containers/json`, you must now request `/v1.25/containers/json`. 123 124 ### Backing filesystem without `d_type` support for overlay/overlay2 125 **Deprecated In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 126 127 **Removed In Release: v17.12** 128 129 The overlay and overlay2 storage driver does not work as expected if the backing 130 filesystem does not support `d_type`. For example, XFS does not support `d_type` 131 if it is formatted with the `ftype=0` option. 132 133 Starting with Docker 17.12, new installations will not support running overlay2 on 134 a backing filesystem without `d_type` support. For existing installations that upgrade 135 to 17.12, a warning will be printed. 136 137 Please also refer to [#27358](https://github.com/docker/docker/issues/27358) for 138 further information. 139 140 ### Three arguments form in `docker import` 141 **Deprecated In Release: [v0.6.7](https://github.com/docker/docker/releases/tag/v0.6.7)** 142 143 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 144 145 The `docker import` command format `file|URL|- [REPOSITORY [TAG]]` is deprecated since November 2013. It's no more supported. 146 147 ### `-h` shorthand for `--help` 148 149 **Deprecated In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 150 151 **Target For Removal In Release: v17.09** 152 153 The shorthand (`-h`) is less common than `--help` on Linux and cannot be used 154 on all subcommands (due to it conflicting with, e.g. `-h` / `--hostname` on 155 `docker create`). For this reason, the `-h` shorthand was not printed in the 156 "usage" output of subcommands, nor documented, and is now marked "deprecated". 157 158 ### `-e` and `--email` flags on `docker login` 159 **Deprecated In Release: [v1.11.0](https://github.com/docker/docker/releases/tag/v1.11.0)** 160 161 **Removed In Release: [v17.06](https://github.com/docker/docker-ce/releases/tag/v17.06.0-ce)** 162 163 The docker login command is removing the ability to automatically register for an account with the target registry if the given username doesn't exist. Due to this change, the email flag is no longer required, and will be deprecated. 164 165 ### Separator (`:`) of `--security-opt` flag on `docker run` 166 **Deprecated In Release: [v1.11.0](https://github.com/docker/docker/releases/tag/v1.11.0)** 167 168 **Target For Removal In Release: v17.06** 169 170 The flag `--security-opt` doesn't use the colon separator (`:`) anymore to divide keys and values, it uses the equal symbol (`=`) for consistency with other similar flags, like `--storage-opt`. 171 172 ### `/containers/(id or name)/copy` endpoint 173 174 **Deprecated In Release: [v1.8.0](https://github.com/docker/docker/releases/tag/v1.8.0)** 175 176 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 177 178 The endpoint `/containers/(id or name)/copy` is deprecated in favor of `/containers/(id or name)/archive`. 179 180 ### Ambiguous event fields in API 181 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 182 183 The fields `ID`, `Status` and `From` in the events API have been deprecated in favor of a more rich structure. 184 See the events API documentation for the new format. 185 186 ### `-f` flag on `docker tag` 187 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 188 189 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 190 191 To make tagging consistent across the various `docker` commands, the `-f` flag on the `docker tag` command is deprecated. It is not longer necessary to specify `-f` to move a tag from one image to another. Nor will `docker` generate an error if the `-f` flag is missing and the specified tag is already in use. 192 193 ### HostConfig at API container start 194 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 195 196 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 197 198 Passing an `HostConfig` to `POST /containers/{name}/start` is deprecated in favor of 199 defining it at container creation (`POST /containers/create`). 200 201 ### `--before` and `--since` flags on `docker ps` 202 203 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 204 205 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 206 207 The `docker ps --before` and `docker ps --since` options are deprecated. 208 Use `docker ps --filter=before=...` and `docker ps --filter=since=...` instead. 209 210 ### `--automated` and `--stars` flags on `docker search` 211 212 **Deprecated in Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 213 214 **Target For Removal In Release: v17.09** 215 216 The `docker search --automated` and `docker search --stars` options are deprecated. 217 Use `docker search --filter=is-automated=...` and `docker search --filter=stars=...` instead. 218 219 ### Driver Specific Log Tags 220 **Deprecated In Release: [v1.9.0](https://github.com/docker/docker/releases/tag/v1.9.0)** 221 222 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 223 224 Log tags are now generated in a standard way across different logging drivers. 225 Because of which, the driver specific log tag options `syslog-tag`, `gelf-tag` and 226 `fluentd-tag` have been deprecated in favor of the generic `tag` option. 227 228 ```bash 229 {% raw %} 230 docker --log-driver=syslog --log-opt tag="{{.ImageName}}/{{.Name}}/{{.ID}}" 231 {% endraw %} 232 ``` 233 234 ### LXC built-in exec driver 235 **Deprecated In Release: [v1.8.0](https://github.com/docker/docker/releases/tag/v1.8.0)** 236 237 **Removed In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 238 239 The built-in LXC execution driver, the lxc-conf flag, and API fields have been removed. 240 241 ### Old Command Line Options 242 **Deprecated In Release: [v1.8.0](https://github.com/docker/docker/releases/tag/v1.8.0)** 243 244 **Removed In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 245 246 The flags `-d` and `--daemon` are deprecated in favor of the `daemon` subcommand: 247 248 docker daemon -H ... 249 250 The following single-dash (`-opt`) variant of certain command line options 251 are deprecated and replaced with double-dash options (`--opt`): 252 253 docker attach -nostdin 254 docker attach -sig-proxy 255 docker build -no-cache 256 docker build -rm 257 docker commit -author 258 docker commit -run 259 docker events -since 260 docker history -notrunc 261 docker images -notrunc 262 docker inspect -format 263 docker ps -beforeId 264 docker ps -notrunc 265 docker ps -sinceId 266 docker rm -link 267 docker run -cidfile 268 docker run -dns 269 docker run -entrypoint 270 docker run -expose 271 docker run -link 272 docker run -lxc-conf 273 docker run -n 274 docker run -privileged 275 docker run -volumes-from 276 docker search -notrunc 277 docker search -stars 278 docker search -t 279 docker search -trusted 280 docker tag -force 281 282 The following double-dash options are deprecated and have no replacement: 283 284 docker run --cpuset 285 docker run --networking 286 docker ps --since-id 287 docker ps --before-id 288 docker search --trusted 289 290 **Deprecated In Release: [v1.5.0](https://github.com/docker/docker/releases/tag/v1.5.0)** 291 292 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 293 294 The single-dash (`-help`) was removed, in favor of the double-dash `--help` 295 296 docker -help 297 docker [COMMAND] -help 298 299 ### `--run` flag on docker commit 300 301 **Deprecated In Release: [v0.10.0](https://github.com/docker/docker/releases/tag/v0.10.0)** 302 303 **Removed In Release: [v1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)** 304 305 The flag `--run` of the docker commit (and its short version `-run`) were deprecated in favor 306 of the `--changes` flag that allows to pass `Dockerfile` commands. 307 308 309 ### Interacting with V1 registries 310 311 **Disabled By Default In Release: v17.06** 312 313 **Removed In Release: v17.12** 314 315 Version 1.8.3 added a flag (`--disable-legacy-registry=false`) which prevents the 316 docker daemon from `pull`, `push`, and `login` operations against v1 317 registries. Though enabled by default, this signals the intent to deprecate 318 the v1 protocol. 319 320 Support for the v1 protocol to the public registry was removed in 1.13. Any 321 mirror configurations using v1 should be updated to use a 322 [v2 registry mirror](https://docs.docker.com/registry/recipes/mirror/). 323 324 Starting with Docker 17.12, support for V1 registries has been removed, and the 325 `--disable-legacy-registry` flag can no longer be used, and `dockerd` will fail to 326 start when set. 327 328 ### `--disable-legacy-registry` override daemon option 329 330 **Disabled In Release: v17.12** 331 332 **Target For Removal In Release: v18.03** 333 334 The `--disable-legacy-registry` flag was disabled in Docker 17.12 and will print 335 an error when used. For this error to be printed, the flag itself is still present, 336 but hidden. The flag will be removed in Docker 18.03. 337 338 339 ### Docker Content Trust ENV passphrase variables name change 340 **Deprecated In Release: [v1.9.0](https://github.com/docker/docker/releases/tag/v1.9.0)** 341 342 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 343 344 Since 1.9, Docker Content Trust Offline key has been renamed to Root key and the Tagging key has been renamed to Repository key. Due to this renaming, we're also changing the corresponding environment variables 345 346 - DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE is now named DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE 347 - DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE is now named DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE 348 349 ### `--api-enable-cors` flag on dockerd 350 351 **Deprecated In Release: [v1.6.0](https://github.com/docker/docker/releases/tag/v1.6.0)** 352 353 **Removed In Release: [v17.09](https://github.com/docker/docker-ce/releases/tag/v17.09.0-ce)** 354 355 The flag `--api-enable-cors` is deprecated since v1.6.0. Use the flag 356 `--api-cors-header` instead.