github.com/kim0/docker@v0.6.2-0.20161130212042-4addda3f07e7/docs/deprecated.md (about) 1 --- 2 aliases: ["/engine/misc/deprecated/"] 3 title: "Deprecated Engine Features" 4 description: "Deprecated Features." 5 keywords: ["docker, documentation, about, technology, deprecate"] 6 --- 7 8 <!-- This file is maintained within the docker/docker Github 9 repository at https://github.com/docker/docker/. Make all 10 pull requests against that repo. If you see this file in 11 another repository, consider it read-only there, as it will 12 periodically be overwritten by the definitive file. Pull 13 requests which include edits to this file in other repositories 14 will be rejected. 15 --> 16 17 # Deprecated Engine Features 18 19 The following list of features are deprecated in Engine. 20 To learn more about Docker Engine's deprecation policy, 21 see [Feature Deprecation Policy](https://docs.docker.com/engine/#feature-deprecation-policy). 22 23 24 ### `repository:shortid` image references 25 **Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/)** 26 27 **Target For Removal In Release: v1.16** 28 29 `repository:shortid` syntax for referencing images is very little used, collides with with tag references can be confused with digest references. 30 31 ### `docker daemon` subcommand 32 **Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/)** 33 34 **Target For Removal In Release: v1.16** 35 36 The daemon is moved to a separate binary (`dockerd`), and should be used instead. 37 38 ### Duplicate keys with conflicting values in engine labels 39 **Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/)** 40 41 **Target For Removal In Release: v1.16** 42 43 Duplicate keys with conflicting values have been deprecated. A warning is displayed 44 in the output, and an error will be returned in the future. 45 46 ### Three argument form in `docker import` 47 **Deprecated In Release: [v0.6.7](https://github.com/docker/docker/releases/tag/v0.6.7)** 48 49 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 50 51 The `docker import` command format 'file|URL|- [REPOSITORY [TAG]]' is deprecated since November 2013. It's no more supported. 52 53 ### `-h` shorthand for `--help` 54 55 **Deprecated In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 56 57 **Target For Removal In Release: v1.15** 58 59 The shorthand (`-h`) is less common than `--help` on Linux and cannot be used 60 on all subcommands (due to it conflicting with, e.g. `-h` / `--hostname` on 61 `docker create`). For this reason, the `-h` shorthand was not printed in the 62 "usage" output of subcommands, nor documented, and is now marked "deprecated". 63 64 ### `-e` and `--email` flags on `docker login` 65 **Deprecated In Release: [v1.11.0](https://github.com/docker/docker/releases/tag/v1.11.0)** 66 67 **Target For Removal In Release: v1.14** 68 69 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. 70 71 ### Separator (`:`) of `--security-opt` flag on `docker run` 72 **Deprecated In Release: [v1.11.0](https://github.com/docker/docker/releases/tag/v1.11.0)** 73 74 **Target For Removal In Release: v1.14** 75 76 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`. 77 78 ### `/containers/(id or name)/copy` endpoint 79 80 **Deprecated In Release: [v1.8.0](https://github.com/docker/docker/releases/tag/v1.8.0)** 81 82 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 83 84 The endpoint `/containers/(id or name)/copy` is deprecated in favor of `/containers/(id or name)/archive`. 85 86 ### Ambiguous event fields in API 87 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 88 89 The fields `ID`, `Status` and `From` in the events API have been deprecated in favor of a more rich structure. 90 See the events API documentation for the new format. 91 92 ### `-f` flag on `docker tag` 93 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 94 95 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 96 97 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. 98 99 ### HostConfig at API container start 100 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 101 102 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 103 104 Passing an `HostConfig` to `POST /containers/{name}/start` is deprecated in favor of 105 defining it at container creation (`POST /containers/create`). 106 107 ### Docker ps 'before' and 'since' options 108 109 **Deprecated In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 110 111 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 112 113 The `docker ps --before` and `docker ps --since` options are deprecated. 114 Use `docker ps --filter=before=...` and `docker ps --filter=since=...` instead. 115 116 ### Docker search 'automated' and 'stars' options 117 118 **Deprecated in Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 119 120 **Target For Removal In Release: v1.15** 121 122 The `docker search --automated` and `docker search --stars` options are deprecated. 123 Use `docker search --filter=is-automated=...` and `docker search --filter=stars=...` instead. 124 125 ### Driver Specific Log Tags 126 **Deprecated In Release: [v1.9.0](https://github.com/docker/docker/releases/tag/v1.9.0)** 127 128 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 129 130 Log tags are now generated in a standard way across different logging drivers. 131 Because of which, the driver specific log tag options `syslog-tag`, `gelf-tag` and 132 `fluentd-tag` have been deprecated in favor of the generic `tag` option. 133 134 docker --log-driver=syslog --log-opt tag="{{.ImageName}}/{{.Name}}/{{.ID}}" 135 136 ### LXC built-in exec driver 137 **Deprecated In Release: [v1.8.0](https://github.com/docker/docker/releases/tag/v1.8.0)** 138 139 **Removed In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 140 141 The built-in LXC execution driver, the lxc-conf flag, and API fields have been removed. 142 143 ### Old Command Line Options 144 **Deprecated In Release: [v1.8.0](https://github.com/docker/docker/releases/tag/v1.8.0)** 145 146 **Removed In Release: [v1.10.0](https://github.com/docker/docker/releases/tag/v1.10.0)** 147 148 The flags `-d` and `--daemon` are deprecated in favor of the `daemon` subcommand: 149 150 docker daemon -H ... 151 152 The following single-dash (`-opt`) variant of certain command line options 153 are deprecated and replaced with double-dash options (`--opt`): 154 155 docker attach -nostdin 156 docker attach -sig-proxy 157 docker build -no-cache 158 docker build -rm 159 docker commit -author 160 docker commit -run 161 docker events -since 162 docker history -notrunc 163 docker images -notrunc 164 docker inspect -format 165 docker ps -beforeId 166 docker ps -notrunc 167 docker ps -sinceId 168 docker rm -link 169 docker run -cidfile 170 docker run -dns 171 docker run -entrypoint 172 docker run -expose 173 docker run -link 174 docker run -lxc-conf 175 docker run -n 176 docker run -privileged 177 docker run -volumes-from 178 docker search -notrunc 179 docker search -stars 180 docker search -t 181 docker search -trusted 182 docker tag -force 183 184 The following double-dash options are deprecated and have no replacement: 185 186 docker run --cpuset 187 docker run --networking 188 docker ps --since-id 189 docker ps --before-id 190 docker search --trusted 191 192 **Deprecated In Release: [v1.5.0](https://github.com/docker/docker/releases/tag/v1.5.0)** 193 194 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 195 196 The single-dash (`-help`) was removed, in favor of the double-dash `--help` 197 198 docker -help 199 docker [COMMAND] -help 200 201 ### `--run` flag on docker commit 202 203 **Deprecated In Release: [v0.10.0](https://github.com/docker/docker/releases/tag/v0.10.0)** 204 205 **Removed In Release: [v1.13.0](https://github.com/docker/docker/releases/)** 206 207 The flag `--run` of the docker commit (and its short version `-run`) were deprecated in favor 208 of the `--changes` flag that allows to pass `Dockerfile` commands. 209 210 211 ### Interacting with V1 registries 212 213 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. 214 215 ### Docker Content Trust ENV passphrase variables name change 216 **Deprecated In Release: [v1.9.0](https://github.com/docker/docker/releases/tag/v1.9.0)** 217 218 **Removed In Release: [v1.12.0](https://github.com/docker/docker/releases/tag/v1.12.0)** 219 220 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 221 222 - DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE is now named DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE 223 - DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE is now named DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE 224 225 ### `MAINTAINER` in Dockerfile 226 **Deprecated In Release: v1.13.0** 227 228 `MAINTAINER` was an early very limited form of `LABEL` which should be used instead.