不推荐的引擎功能 | Deprecated Engine features
已弃用的引擎功能
Engine 中不推荐使用以下功能列表。要了解有关 Docker Engine 弃用策略的更多信息，请参阅功能弃用策略。
异步service create和service update
已弃用在发行版：v17.05.0
在发行版中默认禁用：v17.09
Docker17.05.0添加一个可选--detach=false选项，以使docker service create与docker service update同步工作。Docker 17.09默认启用此选项，此时该--detach标志可用于使用以前的（异步）行为。
-g and --graph flags on dockerd
已弃用在发行版：v17.05.0
or 命令的-gor --graph标志用于指示存储持久性数据和资源配置的目录，并已被替换为更具描述性的标志。dockerddocker daemon--data-root
这些标志是在 Docker 1.0 之前添加的，因此不会被删除，只会隐藏，以阻止它们的使用。
NetworkSettings 中的顶级网络属性
在版本中弃用： v1.13.0
删除目标版本：v17.12
检查容器时，NetworkSettings包含有关默认（“桥梁”）网络的顶级信息;
EndpointID，Gateway，GlobalIPv6Address，GlobalIPv6PrefixLen，IPAddress，IPPrefixLen，IPv6Gateway，和MacAddress。
这些属性不赞成使用每个网络属性NetworkSettings.Networks。这些属性在 Docker 1.9中已经被“弃用”了，但为了向后兼容而保留。
更多信息请参阅＃17538。
filter参数为/images/json端点
在版本中弃用： v1.13.0
删除目标版本：v17.12
现在filter通过引用（名称或名称：标签）过滤图像列表的参数现在作为常规过滤器实现，名为reference。
repository:shortid 图片参考
在版本中弃用： v1.13.0
删除目标版本：v17.12
repository:shortid 用于引用图像的语法很少使用，与标记引用的冲突可能与摘要引用混淆。
docker daemon subcommand
在版本中弃用： v1.13.0
删除目标版本：v17.12
守护进程被移动到一个单独的二进制文件（dockerd），并且应该用来代替。
Duplicate keys with conflicting values in engine labels
在版本中弃用： v1.13.0
删除目标版本：v17.12
具有冲突值的重复键已被弃用。输出中会显示警告，并且将来会返回错误。
MAINTAINER 在Dockerfile中
在版本中弃用： v1.13.0
MAINTAINER是LABEL应该用来代替的早期非常有限的形式。
没有版本的API调用
在版本中弃用： v1.13.0
删除目标版本：v17.12
API 版本应提供给所有 API 调用以确保与未来引擎版本的兼容性。例如/containers/json，您现在必须请求，而不是仅仅请求URL /v1.25/containers/json。
Backing filesystem without d_type support for overlay/overlay2
在版本中弃用： v1.13.0
删除目标版本：v17.12
如果后备文件系统不支持，则 overlay 和 overlay2 存储驱动程序无法按预期工作d_type。例如，d_type如果使用该ftype=0选项格式化XFS，则不支持。
有关更多信息，请参阅＃27358。
三个参数形成 docker import
在版本中弃用： v0.6.7
发布： v1.12.0中删除
该docker import命令格式file|URL|- [REPOSITORY [TAG]]自2013年11月起不再使用，不再受支持。
-h shorthand for --help
在版本中弃用： v1.12.0
删除目标版本：v17.09
简写（-h）不如--help在Linux上常见，并且不能在所有子命令上使用（由于它与例如-h/ --hostnameon 相冲突docker create）。出于这个原因，-h速记没有打印在子命令的“用法”输出中，也没有记录，现在标记为“已弃用”。
-e and --email flags on docker login
在版本中弃用： v1.11.0
发布： v17.06中删除
如果给定的用户名不存在，docker login 命令将删除为目标注册表自动注册帐户的功能。由于此更改，电子邮件标志不再需要，并且将被弃用。
Separator (:) of --security-opt flag on docker run
在版本中弃用： v1.11.0
删除目标版本：v17.06
该标志--security-opt不再使用冒号分隔符（:）来分割键和值，它使用相同的符号（=）与其他类似的标志一致，如--storage-opt。
/containers/(id or name)/copy 端点
在版本中弃用： v1.8.0
发布： v1.12.0中删除
端点/containers/(id or name)/copy已弃用，以支持/containers/(id or name)/archive。
API中的模糊事件字段
已弃用In： v1.10.0
字段ID，Status并且From在事件API已被弃用，取而代之的是更丰富的结构。查看新格式的事件API文档。
-f flag on docker tag
已弃用In： v1.10.0
发布： v1.12.0中删除
为了使标签在各种docker命令中保持一致，命令中的-f标志docker tag已被弃用。不再需要指定-f将标签从一个图像移动到另一个图像。docker如果-f标志丢失并且指定的标签已被使用，也不会产生错误。
HostConfig 在 API 容器启动
已弃用In： v1.10.0
发布： v1.12.0中删除
传递一个HostConfigto POST /containers/{name}/start被弃用，以便在容器创建（POST /containers/create）时定义它。
--before and --since flags on docker ps
已弃用In： v1.10.0
发布： v1.12.0中删除
在docker ps --before和docker ps --since选项已被弃用。使用docker ps --filter=before=...而docker ps --filter=since=...不是。
--automated and --stars flags on docker search
在版本： v1.12.0中弃用
删除目标版本：v17.09
在docker search --automated和docker search --stars选项已被弃用。使用docker search --filter=is-automated=...而docker search --filter=stars=...不是。
驱动程序特定日志标记
弃用版本： v1.9.0
发布： v1.12.0中删除
现在，日志标记通过不同的日志记录驱动程序以标准方式生成。正因为如此，驱动程序特定的日志标记选项syslog-tag，gelf-tag并fluentd-tag已被弃用，以支持通用tag选项。
docker --log-driver=syslog --log-opt tag="{{.ImageName}}/{{.Name}}/{{.ID}}"LXC内置的exec驱动程序
在版本中弃用： v1.8.0
版本中删除： v1.10.0
内置的 LXC 执行驱动程序，lxc-conf 标志和 API 字段已被删除。
旧命令行选项
在发布时被否决：v1.8.0
在释放时移除：v1.10.0
这些标志-d和--daemon被弃用，取而代之的的daemon子命令：
docker daemon -H ...-opt某些命令行选项的以下single-dash（）变体已弃用，并用双短划线选项（--opt）替换：
docker attach -nostdin
docker attach -sig-proxy
docker build -no-cache
docker build -rm
docker commit -author
docker commit -run
docker events -since
docker history -notrunc
docker images -notrunc
docker inspect -format
docker ps -beforeId
docker ps -notrunc
docker ps -sinceId
docker rm -link
docker run -cidfile
docker run -dns
docker run -entrypoint
docker run -expose
docker run -link
docker run -lxc-conf
docker run -n
docker run -privileged
docker run -volumes-from
docker search -notrunc
docker search -stars
docker search -t
docker search -trusted
docker tag -force以下双破折号选项已被弃用且不能替代：
docker run --cpuset
docker run --networking
docker ps --since-id
docker ps --before-id
docker search --trusted在版本中弃用： v1.5.0
发布： v1.12.0中删除
单破折号（-help）被删除，赞成双破折号--help
docker -help
docker [COMMAND] -help--runflag on docker commit
在版本中已弃用： v0.10.0
版本中删除： v1.13.0
该标志--run的搬运工的提交（及其短版-run）有利于被弃用--changes，允许通过标记Dockerfile的命令。
与V1注册管理机构互动
默认情况下禁用发行版：v17.06
删除目标版本：v17.12
版本1.8.3加入的标志（--disable-legacy-registry=false），其防止搬运工守护程序从pull，push和login操作对V1注册表。尽管默认情况下已启用，但这表示意图弃用v1协议。
在1.13中删除了对公共注册表v1协议的支持。任何使用v1的镜像配置都应该更新为使用v2注册镜像。
Docker Content Trust ENV密码短语变量名称更改
弃用版本： v1.9.0
发布： v1.12.0中删除
自1.9以来，Docker Content Trust 脱机密钥已重命名为 Root 密钥，标记密钥已重命名为 Repository 密钥。由于这种重命名，我们也在改变相应的环境变量
- DOCKER_CONTENT_TRUST_OFFLINE_PASSPHRASE现在被命名为DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE
- DOCKER_CONTENT_TRUST_TAGGING_PASSPHRASE现在名为DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE
--api-enable-cors flag on dockerd
弃用版本： v1.6.0
删除目标版本：v17.09
该标志--api-enable-cors自v1.6.0开始不再使用。改用标志--api-cors-header。
本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com
