Skip to content

Commit f23ec25

Browse files
authored
Merge pull request #6095 from thaJeztah/update_schema1_deprecation
docs: move deprecation status of legacy schema1 images to "removed"
2 parents 565b0a2 + f05025c commit f23ec25

File tree

1 file changed

+6
-11
lines changed

1 file changed

+6
-11
lines changed

docs/deprecated.md

Lines changed: 6 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ The following table provides an overview of the current status of deprecated fea
8282
| Removed | [`docker build --stream` flag (experimental)](#docker-build---stream-flag-experimental) | v20.10 | v20.10 |
8383
| Deprecated | [`fluentd-async-connect` log opt](#fluentd-async-connect-log-opt) | v20.10 | v28.0 |
8484
| Removed | [Configuration options for experimental CLI features](#configuration-options-for-experimental-cli-features) | v19.03 | v23.0 |
85-
| Deprecated | [Pushing and pulling with image manifest v2 schema 1](#pushing-and-pulling-with-image-manifest-v2-schema-1) | v19.03 | v27.0 |
85+
| Removed | [Pushing and pulling with image manifest v2 schema 1](#pushing-and-pulling-with-image-manifest-v2-schema-1) | v19.03 | v28.2 |
8686
| Removed | [`docker engine` subcommands](#docker-engine-subcommands) | v19.03 | v20.10 |
8787
| Removed | [Top-level `docker deploy` subcommand (experimental)](#top-level-docker-deploy-subcommand-experimental) | v19.03 | v20.10 |
8888
| Removed | [`docker stack deploy` using "dab" files (experimental)](#docker-stack-deploy-using-dab-files-experimental) | v19.03 | v20.10 |
@@ -737,7 +737,8 @@ for the old option will be removed in a future release.
737737

738738
**Disabled by default in Release: v26.0**
739739

740-
**Target For Removal In Release: v27.0**
740+
**Removed in Release: v28.2**
741+
741742

742743
The image manifest [v2 schema 1](https://distribution.github.io/distribution/spec/deprecated-schema-v1/)
743744
and "Docker Image v1" formats were deprecated in favor of the
@@ -748,23 +749,17 @@ formats.
748749
These legacy formats should no longer be used, and users are recommended to
749750
update images to use current formats, or to upgrade to more current images.
750751
Starting with Docker v26.0, pulling these images is disabled by default, and
751-
produces an error when attempting to pull the image:
752+
support has been removed in v28.2. Attempting to pull a legacy image now
753+
produces an error:
752754

753755
```console
754756
$ docker pull ubuntu:10.04
755757
Error response from daemon:
756-
[DEPRECATION NOTICE] Docker Image Format v1 and Docker Image manifest version 2, schema 1 support is disabled by default and will be removed in an upcoming release.
758+
Docker Image Format v1 and Docker Image manifest version 2, schema 1 support has been removed.
757759
Suggest the author of docker.io/library/ubuntu:10.04 to upgrade the image to the OCI Format or Docker Image manifest v2, schema 2.
758760
More information at https://docs.docker.com/go/deprecated-image-specs/
759761
```
760762

761-
An environment variable (`DOCKER_ENABLE_DEPRECATED_PULL_SCHEMA_1_IMAGE`) is
762-
added in Docker v26.0 that allows re-enabling support for these image formats
763-
in the daemon. This environment variable must be set to a non-empty value in
764-
the daemon's environment (for example, through a [systemd override file](https://docs.docker.com/config/daemon/systemd/)).
765-
Support for the `DOCKER_ENABLE_DEPRECATED_PULL_SCHEMA_1_IMAGE` environment variable
766-
will be removed in Docker v27.0 after which this functionality is removed permanently.
767-
768763
### `docker engine` subcommands
769764

770765
**Deprecated in Release: v19.03**

0 commit comments

Comments
 (0)