docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Reword and reformat "Breaking changes" page (#473) 

* Update breaking_changes.md

* Update breaking_changes.md

* Update breaking_changes.md

* Update breaking_changes.md

* Update breaking_changes.md

* Update breaking_changes.md
This commit is contained in:
John Mulhausen 2016-11-05 16:18:41 -07:00 committed by GitHub
parent 5f38b8ee4f
commit a0aa3e7321
1 changed files with 16 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
engine/breaking_changes.md
View File

@ -8,29 +8,29 @@ keywords:
title: Breaking changes and incompatibilities title: Breaking changes and incompatibilities
--- ---
Every Engine release strives to be backward compatible with its predecessors. Every Engine release strives to be backward compatible with its predecessors,
In all cases, the policy is that feature removal is communicated two releases and interface stability is always a priority at Docker.
In all cases, feature removal is communicated three releases
in advance and documented as part of the [deprecated features](deprecated.md) in advance and documented as part of the [deprecated features](deprecated.md)
page. page.
Unfortunately, Docker is a fast moving project, and newly introduced features The following list compiles any updates to Docker Engine that created
may sometime introduce breaking changes and/or incompatibilities. This page backwards-incompatibility for old versions of Docker tools.
documents these by Engine version.
# Engine 1.12 > Note: In the case of your local environment, you should be updating your
Docker Engine using [Docker for Mac](/docker-for-mac),
Docker clients <= 1.9.2 used an invalid Host header when making request to the [Docker for Windows](/docker-for-windows). That way all your tools stay
daemon. Docker 1.12 is built using golang 1.6 which is now checking the validity in sync with Docker Engine.
of the Host header and as such clients <= 1.9.2 can't talk anymore to the daemon.
[An environment variable was added to overcome this issue.](reference/commandline/dockerd.md#miscellaneous-options)
# Engine 1.10 # Engine 1.10
There were two breaking changes in the 1.10 release. There were two breaking changes in the 1.10 release that affected
Registry and Docker Content Trust:
## Registry **Registry**
Registry 2.3 includes improvements to the image manifest that have caused a Registry 2.3 includes improvements to the image manifest that caused a
breaking change. Images pushed by Engine 1.10 to a Registry 2.3 cannot be breaking change. Images pushed by Engine 1.10 to a Registry 2.3 cannot be
pulled by digest by older Engine versions. A `docker pull` that encounters this pulled by digest by older Engine versions. A `docker pull` that encounters this
situation returns the following error: situation returns the following error:
@ -47,7 +47,7 @@ If you are using an older Registry version (< 2.3), this problem does not occur
with any version of the Engine CLI; push, pull, with and without content trust with any version of the Engine CLI; push, pull, with and without content trust
work as you would expect. work as you would expect.
## Docker Content Trust **Docker Content Trust**
Engine older than the current 1.10 cannot pull images from repositories that Engine older than the current 1.10 cannot pull images from repositories that
have enabled key delegation. Key delegation is a feature which requires a have enabled key delegation. Key delegation is a feature which requires a