Skip to content

Commit bbfbd54

Browse files
committed
docs: deprecated: fallback for non-OCI-compliant registries is removed
GitHub deprecated the legacy registry, and it was [sunset on Feb 24th, 2025][1] in favor of GitHub Container Registry (GHCR) (ghcr.io), so the fallback was removed. [1]: https://github.blog/changelog/2025-01-23-legacy-docker-registry-closing-down/ Signed-off-by: Sebastiaan van Stijn <[email protected]>
1 parent a29e53d commit bbfbd54

File tree

1 file changed

+9
-11
lines changed

1 file changed

+9
-11
lines changed

docs/deprecated.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ The following table provides an overview of the current status of deprecated fea
7171
| Removed | [Btrfs storage driver on CentOS 7 and RHEL 7](#btrfs-storage-driver-on-centos-7-and-rhel-7) | v20.10 | v23.0 |
7272
| Removed | [Support for encrypted TLS private keys](#support-for-encrypted-tls-private-keys) | v20.10 | v23.0 |
7373
| Removed | [Kubernetes stack and context support](#kubernetes-stack-and-context-support) | v20.10 | v23.0 |
74-
| Deprecated | [Pulling images from non-compliant image registries](#pulling-images-from-non-compliant-image-registries) | v20.10 | - |
74+
| Removed | [Pulling images from non-compliant image registries](#pulling-images-from-non-compliant-image-registries) | v20.10 | v28.2 |
7575
| Removed | [Linux containers on Windows (LCOW)](#linux-containers-on-windows-lcow-experimental) | v20.10 | v23.0 |
7676
| Deprecated | [BLKIO weight options with cgroups v1](#blkio-weight-options-with-cgroups-v1) | v20.10 | - |
7777
| Removed | [Kernel memory limit](#kernel-memory-limit) | v20.10 | v23.0 |
@@ -547,6 +547,7 @@ CLI configuration file are no longer used, and ignored.
547547
### Pulling images from non-compliant image registries
548548

549549
**Deprecated in Release: v20.10**
550+
**Removed in Release: v28.2**
550551

551552
Docker Engine v20.10 and up includes optimizations to verify if images in the
552553
local image cache need updating before pulling, preventing the Docker Engine
@@ -556,7 +557,7 @@ image registry to conform to the [Open Container Initiative Distribution Specifi
556557
While most registries conform to the specification, we encountered some registries
557558
to be non-compliant, resulting in `docker pull` to fail.
558559

559-
As a temporary solution, Docker Engine v20.10 includes a fallback mechanism to
560+
As a temporary solution, Docker Engine v20.10 added a fallback mechanism to
560561
allow `docker pull` to be functional when using a non-compliant registry. A
561562
warning message is printed in this situation:
562563

@@ -565,16 +566,13 @@ warning message is printed in this situation:
565566
pull by tag. This fallback is DEPRECATED, and will be removed in a future
566567
release.
567568

568-
The fallback is added to allow users to either migrate their images to a compliant
569-
registry, or for these registries to become compliant.
570-
571-
Note that this fallback only addresses failures on `docker pull`. Other commands,
572-
such as `docker stack deploy`, or pulling images with `containerd` will continue
573-
to fail.
569+
The fallback was added to allow users to either migrate their images to a
570+
compliant registry, or for these registries to become compliant.
574571

575-
Given that other functionality is still broken with these registries, we consider
576-
this fallback a _temporary_ solution, and will remove the fallback in an upcoming
577-
major release.
572+
GitHub deprecated the legacy `docker.pkg.github.com` registry, and it was
573+
[sunset on Feb 24th, 2025](https://github.blog/changelog/2025-01-23-legacy-docker-registry-closing-down/)
574+
in favor of GitHub Container Registry (GHCR, ghcr.io), making this fallback
575+
no longer needed.
578576

579577
### Linux containers on Windows (LCOW) (experimental)
580578

0 commit comments

Comments
 (0)