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.