mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
3d6f5984f5
BenchmarkWithHack-4 50000 37082 ns/op 44.50 MB/s 1920 B/op 30 allocs/op BenchmarkNoHack-4 50000 30829 ns/op 53.52 MB/s 0 B/op 0 allocs/op Signed-off-by: Brian Goff <cpuguy83@gmail.com> Signed-off-by: Antonio Murdaca <runcom@redhat.com>
59 lines
2.1 KiB
Markdown
59 lines
2.1 KiB
Markdown
<!--[metadata]>
|
|
+++
|
|
aliases = ["/engine/misc/breaking/"]
|
|
title = "Breaking changes"
|
|
description = "Breaking changes"
|
|
keywords = ["docker, documentation, about, technology, breaking",
|
|
"incompatibilities"]
|
|
[menu.main]
|
|
parent = "engine_use"
|
|
weight=80
|
|
+++
|
|
<![end-metadata]-->
|
|
|
|
# Breaking changes and incompatibilities
|
|
|
|
Every Engine release strives to be backward compatible with its predecessors.
|
|
In all cases, the policy is that feature removal is communicated two releases
|
|
in advance and documented as part of the [deprecated features](deprecated.md)
|
|
page.
|
|
|
|
Unfortunately, Docker is a fast moving project, and newly introduced features
|
|
may sometime introduce breaking changes and/or incompatibilities. This page
|
|
documents these by Engine version.
|
|
|
|
# Engine 1.12
|
|
|
|
Docker clients <= 1.9.2 used an invalid Host header when making request to the
|
|
daemon. Docker 1.12 is built using golang 1.6 which is now checking the validity
|
|
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
|
|
|
|
There were two breaking changes in the 1.10 release.
|
|
|
|
## Registry
|
|
|
|
Registry 2.3 includes improvements to the image manifest that have caused a
|
|
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
|
|
situation returns the following error:
|
|
|
|
```
|
|
Error response from daemon: unsupported schema version 2 for tag TAGNAME
|
|
```
|
|
|
|
Docker Content Trust heavily relies on pull by digest. As a result, images
|
|
pushed from the Engine 1.10 CLI to a 2.3 Registry cannot be pulled by older
|
|
Engine CLIs (< 1.10) with Docker Content Trust enabled.
|
|
|
|
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
|
|
work as you would expect.
|
|
|
|
## Docker Content Trust
|
|
|
|
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
|
|
manual action to enable.
|