github.com/kobeld/docker@v1.12.0-rc1/docs/deprecated.md (about) 1 <!--[metadata]> 2 +++ 3 aliases = ["/engine/misc/deprecated/"] 4 title = "Deprecated Engine Features" 5 description = "Deprecated Features." 6 keywords = ["docker, documentation, about, technology, deprecate"] 7 [menu.main] 8 parent = "engine_use" 9 weight=80 10 +++ 11 <![end-metadata]--> 12 13 # Deprecated Engine Features 14 15 The following list of features are deprecated in Engine. 16 17 ### Three argument form in `docker import` 18 **Deprecated In Release: [v0.6.7](https://github.com/docker/docker/releases/tag/v0.6.7)** 19 20 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 21 22 The `docker import` command format 'file|URL|- [REPOSITORY [TAG]]' is deprecated since November 2013. It's no more supported. 23 24 ### `-e` and `--email` flags on `docker login` 25 **Deprecated In Release: [v1.11.0](https://github.com/docker/docker/releases/tag/v1.11.0)** 26 27 **Target For Removal In Release: v1.13** 28 29 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. 30 31 ### Separator (`:`) of `--security-opt` flag on `docker run` 32 **Deprecated In Release: [v1.11.0](https://github.com/docker/docker/releases/tag/v1.11.0)** 33 34 **Target For Removal In Release: v1.13** 35 36 The flag `--security-opt` doesn't use the colon separator(`:`) anymore to divide keys and values, it uses the equal symbol(`=`) for consinstency with other similar flags, like `--storage-opt`. 37 38 ### `/containers/(id or name)/copy` endpoint 39 40 **Deprecated In Release: v1.8** 41 42 **Removed In Release: v1.12.0** 43 44 The endpoint `/containers/(id or name)/copy` is deprecated in favor of `/containers/(id or name)/archive`. 45 46 ### Ambiguous event fields in API 47 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 48 49 The fields `ID`, `Status` and `From` in the events API have been deprecated in favor of a more rich structure. 50 See the events API documentation for the new format. 51 52 ### `-f` flag on `docker tag` 53 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 54 55 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 56 57 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. 58 59 ### HostConfig at API container start 60 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 61 62 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 63 64 Passing an `HostConfig` to `POST /containers/{name}/start` is deprecated in favor of 65 defining it at container creation (`POST /containers/create`). 66 67 ### Docker ps 'before' and 'since' options 68 69 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 70 71 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 72 73 The `docker ps --before` and `docker ps --since` options are deprecated. 74 Use `docker ps --filter=before=...` and `docker ps --filter=since=...` instead. 75 76 ### Docker search 'automated' and 'stars' options 77 78 **Deprecated in Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 79 80 **Target For Removal In Release: v1.14** 81 82 The `docker search --automated` and `docker search --stars` options are deprecated. 83 Use `docker search --filter=is-automated=...` and `docker search --filter=stars=...` instead. 84 85 ### Driver Specific Log Tags 86 **Deprecated In Release: [v1.9.0](https://github.com/docker/docker/releases/tag/v1.9.0)** 87 88 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 89 90 Log tags are now generated in a standard way across different logging drivers. 91 Because of which, the driver specific log tag options `syslog-tag`, `gelf-tag` and 92 `fluentd-tag` have been deprecated in favor of the generic `tag` option. 93 94 docker --log-driver=syslog --log-opt tag="{{.ImageName}}/{{.Name}}/{{.ID}}" 95 96 ### LXC built-in exec driver 97 **Deprecated In Release: [v1.8.0](https://github.com/docker/docker/releases/tag/v1.8.0)** 98 99 **Removed In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 100 101 The built-in LXC execution driver, the lxc-conf flag, and API fields have been removed. 102 103 ### Old Command Line Options 104 **Deprecated In Release: [v1.8.0](https://github.com/docker/docker/releases/tag/v1.8.0)** 105 106 **Removed In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 107 108 The flags `-d` and `--daemon` are deprecated in favor of the `daemon` subcommand: 109 110 docker daemon -H ... 111 112 The following single-dash (`-opt`) variant of certain command line options 113 are deprecated and replaced with double-dash options (`--opt`): 114 115 docker attach -nostdin 116 docker attach -sig-proxy 117 docker build -no-cache 118 docker build -rm 119 docker commit -author 120 docker commit -run 121 docker events -since 122 docker history -notrunc 123 docker images -notrunc 124 docker inspect -format 125 docker ps -beforeId 126 docker ps -notrunc 127 docker ps -sinceId 128 docker rm -link 129 docker run -cidfile 130 docker run -dns 131 docker run -entrypoint 132 docker run -expose 133 docker run -link 134 docker run -lxc-conf 135 docker run -n 136 docker run -privileged 137 docker run -volumes-from 138 docker search -notrunc 139 docker search -stars 140 docker search -t 141 docker search -trusted 142 docker tag -force 143 144 The following double-dash options are deprecated and have no replacement: 145 146 docker run --cpuset 147 docker run --networking 148 docker ps --since-id 149 docker ps --before-id 150 docker search --trusted 151 152 ### Interacting with V1 registries 153 154 Version 1.9 adds a flag (`--disable-legacy-registry=false`) which prevents the docker daemon from `pull`, `push`, and `login` operations against v1 registries. Though disabled by default, this signals the intent to deprecate the v1 protocol. 155 156 ### Docker Content Trust ENV passphrase variables name change 157 **Deprecated In Release: [v1.9.0](https://github.com/docker/docker/releases/tag/v1.9.0)** 158 159 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 160 161 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 162 163 - DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE is now named DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE 164 - DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE is now named DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE