53 lines
1.9 KiB
Markdown
53 lines
1.9 KiB
Markdown
---
|
|
redirect_from:
|
|
- /engine/misc/breaking/
|
|
description: Breaking changes
|
|
keywords: docker, documentation, about, technology, breaking, incompatibilities
|
|
title: Breaking changes and incompatibilities
|
|
---
|
|
|
|
Every Engine release strives to be backward compatible with its predecessors,
|
|
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)
|
|
page.
|
|
|
|
The following list compiles any updates to Docker Engine that created
|
|
backwards-incompatibility for old versions of Docker tools.
|
|
|
|
> **Note**: In the case of your local environment, you should be updating your
|
|
Docker Engine using [Docker Desktop for Mac](/docker-for-mac),
|
|
[Docker Desktop for Windows](/docker-for-windows). That way all your tools stay
|
|
in sync with Docker Engine.
|
|
|
|
## Engine 1.10
|
|
|
|
There were two breaking changes in the 1.10 release that affected
|
|
Registry and Docker Content Trust:
|
|
|
|
**Registry**
|
|
|
|
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
|
|
pulled by digest by older Engine versions. A `docker pull` that encounters this
|
|
situation returns the following error:
|
|
|
|
```none
|
|
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.
|