From d7d5762a77d7a9b633b8b91aa338f15a856240bd Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Thu, 16 Jan 2025 14:49:42 +0100 Subject: [PATCH 1/4] manuals: add page on deprecated and retired features Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- content/manuals/cloud/index.md | 23 ----- content/manuals/registry.md | 94 ----------------- content/manuals/retired.md | 183 +++++++++++++++++++++++++++++++++ 3 files changed, 183 insertions(+), 117 deletions(-) delete mode 100644 content/manuals/cloud/index.md delete mode 100644 content/manuals/registry.md create mode 100644 content/manuals/retired.md diff --git a/content/manuals/cloud/index.md b/content/manuals/cloud/index.md deleted file mode 100644 index 7f6517780766..000000000000 --- a/content/manuals/cloud/index.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Cloud integrations -description: ACI and ECS integration information -keywords: compose, ACI, ECS, amazon, cloud integration -params: - sidebar: - group: Products -aliases: -- /engine/context/aci-integration/ -- /cloud/aci-integration/ -- /cloud/ecs-integration/ -- /cloud/ecs-compose-examples/ -- /cloud/ecs-compose-features/ -- /cloud/ecs-architecture/ -- /cloud/aci-compose-features/ -- /cloud/aci-container-features/ -- /engine/context/ecs-integration/ ---- - -Docker Compose's integration for Amazon's Elastic Container Service and Azure Container Instances has retired. The integration documentation is no longer available through the Docker Docs site. - -However, you can still access the relevant documentation in the [Compose CLI repository](https://github.com/docker/compose-cli/tree/main/docs). - diff --git a/content/manuals/registry.md b/content/manuals/registry.md deleted file mode 100644 index ac668945ee49..000000000000 --- a/content/manuals/registry.md +++ /dev/null @@ -1,94 +0,0 @@ ---- -title: Registry -description: The Docker Hub registry implementation -keywords: registry, distribution, docker hub, spec, schema, api, manifest, auth -params: - sidebar: - group: Open source -aliases: - - /registry/compatibility/ - - /registry/configuration/ - - /registry/deploying/ - - /registry/deprecated/ - - /registry/garbage-collection/ - - /registry/help/ - - /registry/insecure/ - - /registry/introduction/ - - /registry/notifications/ - - /registry/recipes/ - - /registry/recipes/apache/ - - /registry/recipes/nginx/ - - /registry/recipes/osx-setup-guide/ - - /registry/spec/ - - /registry/spec/api/ - - /registry/spec/auth/ - - /registry/spec/auth/jwt/ - - /registry/spec/auth/oauth/ - - /registry/spec/auth/scope/ - - /registry/spec/auth/token/ - - /registry/spec/deprecated-schema-v1/ - - /registry/spec/implementations/ - - /registry/spec/json/ - - /registry/spec/manifest-v2-1/ - - /registry/spec/manifest-v2-2/ - - /registry/spec/menu/ - - /registry/storage-drivers/ - - /registry/storage-drivers/azure/ - - /registry/storage-drivers/filesystem/ - - /registry/storage-drivers/gcs/ - - /registry/storage-drivers/inmemory/ - - /registry/storage-drivers/oss/ - - /registry/storage-drivers/s3/ - - /registry/storage-drivers/swift/ ---- - -> [!IMPORTANT] -> -> The ability to push [deprecated Docker image manifest version 2, schema 1](https://distribution.github.io/distribution/spec/deprecated-schema-v1/) images to Docker Hub is deprecated as of November 4th, 2024. - -Registry, the open source implementation for storing and distributing container -images and other content, has been donated to the CNCF. Registry now goes under -the name of Distribution, and the documentation has moved to -[distribution/distribution]. - -The Docker Hub registry implementation is based on Distribution. Docker Hub -implements version 1.0.1 OCI distribution [specification]. For reference -documentation on the API protocol that Docker Hub implements, refer to the OCI -distribution specification. - -## Supported media types - -Docker Hub supports the following image manifest formats for pulling images: - -- [OCI image manifest] -- [Docker image manifest version 2, schema 2] -- Docker image manifest version 2, schema 1 -- Docker image manifest version 1 - -You can push images with the following formats: - -- [OCI image manifest] -- [Docker image manifest version 2, schema 2] - -Docker Hub also supports OCI artifacts. See [OCI artifacts]. - -## Authentication - -For documentation related to authentication to the Docker Hub registry, see: - -- [Token authentication specification][token] -- [OAuth 2.0 token authentication][oauth2] -- [JWT authentication][jwt] -- [Token scope and access][scope] - - - -[distribution/distribution]: https://distribution.github.io/distribution/ -[specification]: https://github.com/opencontainers/distribution-spec/blob/v1.0.1/spec.md -[OCI image manifest]: https://github.com/opencontainers/image-spec/blob/main/manifest.md -[Docker image manifest version 2, schema 2]: https://distribution.github.io/distribution/spec/manifest-v2-2/ -[OCI artifacts]: /docker-hub/repos/manage/hub-images/oci-artifacts/ -[oauth2]: https://distribution.github.io/distribution/spec/auth/oauth/ -[jwt]: https://distribution.github.io/distribution/spec/auth/jwt/ -[token]: https://distribution.github.io/distribution/spec/auth/token/ -[scope]: https://distribution.github.io/distribution/spec/auth/scope/ diff --git a/content/manuals/retired.md b/content/manuals/retired.md new file mode 100644 index 000000000000..17a6585432f2 --- /dev/null +++ b/content/manuals/retired.md @@ -0,0 +1,183 @@ +--- +title: Deprecated and retired Docker products and features +linkTitle: Deprecated products and features +description: | + Explore deprecated and retired Docker features, products, and open source + projects, including details on transitioned tools and archived initiatives. +params: + sidebar: + group: Products +aliases: + - /cloud/ + - /cloud/aci-compose-features/ + - /cloud/aci-container-features/ + - /cloud/aci-integration/ + - /cloud/ecs-architecture/ + - /cloud/ecs-compose-examples/ + - /cloud/ecs-compose-features/ + - /cloud/ecs-integration/ + - /engine/context/aci-integration/ + - /engine/context/ecs-integration/ + - /registry/ + - /registry/compatibility/ + - /registry/configuration/ + - /registry/deploying/ + - /registry/deprecated/ + - /registry/garbage-collection/ + - /registry/help/ + - /registry/insecure/ + - /registry/introduction/ + - /registry/notifications/ + - /registry/recipes/ + - /registry/recipes/apache/ + - /registry/recipes/nginx/ + - /registry/recipes/osx-setup-guide/ + - /registry/spec/ + - /registry/spec/api/ + - /registry/spec/auth/ + - /registry/spec/auth/jwt/ + - /registry/spec/auth/oauth/ + - /registry/spec/auth/scope/ + - /registry/spec/auth/token/ + - /registry/spec/deprecated-schema-v1/ + - /registry/spec/implementations/ + - /registry/spec/json/ + - /registry/spec/manifest-v2-1/ + - /registry/spec/manifest-v2-2/ + - /registry/spec/menu/ + - /registry/storage-drivers/ + - /registry/storage-drivers/azure/ + - /registry/storage-drivers/filesystem/ + - /registry/storage-drivers/gcs/ + - /registry/storage-drivers/inmemory/ + - /registry/storage-drivers/oss/ + - /registry/storage-drivers/s3/ + - /registry/storage-drivers/swift/ +--- + +This document provides an overview of Docker features, products, and +open-source projects that have been deprecated, retired, or transitioned. + +> [!NOTE] +> +> This page does not cover deprecated and removed Docker Engine features. +> For a detailed list of deprecated Docker Engine features, refer to the +> [Docker Engine Deprecated Features documentation](/manuals/engine/deprecated.md). + +## Products and features + +Support for these deprecated or retired features is no longer provided by +Docker, Inc. The projects that have been transitioned to third parties continue +to receive updates from their new maintainers. + +### Docker Machine + +Docker Machine was a tool for provisioning and managing Docker hosts across +various platforms, including virtual machines and cloud providers. It is no +longer maintained, and users are encouraged to use [Docker Desktop](/manuals/desktop/_index.md) +or [Docker Engine](/manuals/engine/_index.md) directly on supported platforms. +Machine's approach to creating and configuring hosts has been superseded by +more modern workflows that integrate more closely with Docker Desktop. + +### Docker Toolbox + +Docker Toolbox was used on older systems where Docker Desktop could not run. It +bundled Docker Machine, Docker Engine, and Docker Compose into a single +installer. Toolbox is no longer maintained and is effectively replaced by +[Docker Desktop](/manuals/desktop/_index.md) on current systems. References to +Docker Toolbox occasionally appear in older documentation or community +tutorials, but it is not recommended for new installations. + +### Docker Cloud integrations + +Docker previously offered integrations for Amazon's Elastic Container Service +(ECS) and Azure Container Instances (ACI) to streamline container workflows. +These integrations have been deprecated, and users should now rely on native +cloud tools or third-party solutions to manage their workloads. The move toward +platform-specific or universal orchestration tools reduced the need for +specialized Docker Cloud integrations. + +You can still view the relevant documentation for these integrations in the +[Compose CLI repository](https://github.com/docker-archive/compose-cli/tree/main/docs). + +### Docker Enterprise Edition + +Docker Enterprise Edition (EE) was Docker's commercial platform for deploying +and managing large-scale container environments. It was acquired by Mirantis in +2019, and users looking for enterprise-level functionality can now explore +Mirantis Kubernetes Engine or other products offered by Mirantis. Much of the +technology and features found in Docker EE have been absorbed into the Mirantis +product line. + +> [!NOTE] +> For information about enterprise-level features offered by Docker today, +> see the [Docker Business subscription](/manuals/subscription/details.md#docker-business). + +### Docker Data Center and Docker Trusted Registry + +Docker Data Center (DDC) was an umbrella term that encompassed Docker Universal +Control Plane (UCP) and Docker Trusted Registry (DTR). These components +provided a full-stack solution for managing containers, security, and registry +services in enterprise environments. They are now under the Mirantis portfolio +following the Docker Enterprise acquisition. Users still encountering +references to DDC, UCP, or DTR should refer to Mirantis's documentation for +guidance on modern equivalents. + +### Dev Environments + +Dev Environments was a feature introduced in Docker Desktop that allowed +developers to spin up development environments quickly. This feature is no +longer under active development. Similar workflows can be achieved through +Docker Compose or by creating custom configurations tailored to specific +project requirements. + +## Open source projects + +Several open-source projects originally maintained by Docker have been +archived, discontinued, or transitioned to other maintainers or organizations. + +### Registry (now CNCF Distribution) + +The Docker Registry served as the open-source implementation of a container +image registry. It was donated to the Cloud Native Computing Foundation (CNCF) +in 2019 and is maintained under the name "Distribution." It remains a +cornerstone for managing and distributing container images. + +[CNCF Distribution](https://github.com/distribution/distribution) + +### Docker Compose v1 (replaced by Compose v2) + +Docker Compose v1 (`docker-compose`), a Python-based tool for defining +multi-container applications, has been superseded by Compose v2 (`docker +compose`), which is written in Go and integrates with the Docker CLI. Compose +v1 is no longer maintained, and users should migrate to Compose v2. + +[Compose v2 Documentation](/manuals/compose/_index.md) + +### InfraKit + +InfraKit was an open-source toolkit designed to manage declarative +infrastructure and automate container deployments. It has been archived, and +users are encouraged to explore tools such as Terraform for infrastructure +provisioning and orchestration. + +[InfraKit GitHub Repository](https://github.com/docker/infrakit) + +### Docker Notary (now CNCF Notary) + +Docker Notary was a system for signing and verifying the authenticity of +container content. It was donated to the CNCF in 2017 and continues to be +developed as "Notary." Users seeking secure content verification should consult +the CNCF Notary project. + +[CNCF Notary](https://github.com/notaryproject/notary) + +### SwarmKit + +SwarmKit powers Docker Swarm mode by providing orchestration for container +deployments. While Swarm mode remains functional, development has slowed in +favor of Kubernetes-based solutions. Individuals evaluating container +orchestration options should investigate whether SwarmKit meets modern workload +requirements. + +[SwarmKit GitHub Repository](https://github.com/docker/swarmkit) From 9bd54a35670c3bba0e6c1d54109d592e8f31d005 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Mon, 27 Jan 2025 13:21:24 +0100 Subject: [PATCH 2/4] vendor: github.com/moby/moby v27.5.1 Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- _vendor/modules.txt | 2 +- go.mod | 4 ++-- go.sum | 2 ++ 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/_vendor/modules.txt b/_vendor/modules.txt index 1a83022753c9..8a604715e58b 100644 --- a/_vendor/modules.txt +++ b/_vendor/modules.txt @@ -1,4 +1,4 @@ -# github.com/moby/moby v27.5.0+incompatible +# github.com/moby/moby v27.5.1+incompatible # github.com/moby/buildkit v0.19.0 # github.com/docker/buildx v0.20.1 # github.com/docker/cli v27.5.0+incompatible diff --git a/go.mod b/go.mod index 595dcbb688bc..ad9b41323b9f 100644 --- a/go.mod +++ b/go.mod @@ -8,7 +8,7 @@ require ( github.com/docker/compose/v2 v2.32.4 // indirect github.com/docker/scout-cli v1.15.0 // indirect github.com/moby/buildkit v0.19.0 // indirect - github.com/moby/moby v27.5.0+incompatible // indirect + github.com/moby/moby v27.5.1+incompatible // indirect ) replace ( @@ -17,5 +17,5 @@ replace ( github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.32.4 github.com/docker/scout-cli => github.com/docker/scout-cli v1.15.0 github.com/moby/buildkit => github.com/moby/buildkit v0.19.0 - github.com/moby/moby => github.com/moby/moby v27.5.0+incompatible + github.com/moby/moby => github.com/moby/moby v27.5.1+incompatible ) diff --git a/go.sum b/go.sum index 76a15346c1eb..893ceecc2e2b 100644 --- a/go.sum +++ b/go.sum @@ -374,6 +374,8 @@ github.com/moby/moby v27.4.0+incompatible h1:jGXXZCMAmFZS9pKsQqUt9yAPHOC450PM9lb github.com/moby/moby v27.4.0+incompatible/go.mod h1:fDXVQ6+S340veQPv35CzDahGBmHsiclFwfEygB/TWMc= github.com/moby/moby v27.5.0+incompatible h1:RuYLppjLxMzWmPUQAy/hkJ6pGcXsuVdcmIVFqVPegO8= github.com/moby/moby v27.5.0+incompatible/go.mod h1:fDXVQ6+S340veQPv35CzDahGBmHsiclFwfEygB/TWMc= +github.com/moby/moby v27.5.1+incompatible h1:/pN59F/t3U7Q4FPzV88nzqf7Fp0qqCSL2KzhZaiKcKw= +github.com/moby/moby v27.5.1+incompatible/go.mod h1:fDXVQ6+S340veQPv35CzDahGBmHsiclFwfEygB/TWMc= github.com/moby/sys/symlink v0.1.0/go.mod h1:GGDODQmbFOjFsXvfLVn3+ZRxkch54RkSiGqsZeMYowQ= github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= github.com/morikuni/aec v1.0.0/go.mod h1:BbKIizmSmc5MMPqRYbxO4ZU0S0+P200+tUnFx7PXmsc= From e9499beda11bf55bd359c370ae09c4c7bd7d2f91 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Mon, 27 Jan 2025 13:28:11 +0100 Subject: [PATCH 3/4] vendor: github.com/docker/cli v27.5.1 Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- _vendor/modules.txt | 2 +- go.mod | 4 ++-- go.sum | 2 ++ 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/_vendor/modules.txt b/_vendor/modules.txt index 8a604715e58b..ae4caa515541 100644 --- a/_vendor/modules.txt +++ b/_vendor/modules.txt @@ -1,6 +1,6 @@ # github.com/moby/moby v27.5.1+incompatible # github.com/moby/buildkit v0.19.0 # github.com/docker/buildx v0.20.1 -# github.com/docker/cli v27.5.0+incompatible +# github.com/docker/cli v27.5.1+incompatible # github.com/docker/compose/v2 v2.32.4 # github.com/docker/scout-cli v1.15.0 diff --git a/go.mod b/go.mod index ad9b41323b9f..fc8141cfeb4b 100644 --- a/go.mod +++ b/go.mod @@ -4,7 +4,7 @@ go 1.23.1 require ( github.com/docker/buildx v0.20.1 // indirect - github.com/docker/cli v27.5.0+incompatible // indirect + github.com/docker/cli v27.5.1+incompatible // indirect github.com/docker/compose/v2 v2.32.4 // indirect github.com/docker/scout-cli v1.15.0 // indirect github.com/moby/buildkit v0.19.0 // indirect @@ -13,7 +13,7 @@ require ( replace ( github.com/docker/buildx => github.com/docker/buildx v0.20.1 - github.com/docker/cli => github.com/docker/cli v27.5.0+incompatible + github.com/docker/cli => github.com/docker/cli v27.5.1+incompatible github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.32.4 github.com/docker/scout-cli => github.com/docker/scout-cli v1.15.0 github.com/moby/buildkit => github.com/moby/buildkit v0.19.0 diff --git a/go.sum b/go.sum index 893ceecc2e2b..00c548363c16 100644 --- a/go.sum +++ b/go.sum @@ -144,6 +144,8 @@ github.com/docker/cli v27.4.0+incompatible h1:/nJzWkcI1MDMN+U+px/YXnQWJqnu4J+QKG github.com/docker/cli v27.4.0+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8= github.com/docker/cli v27.5.0+incompatible h1:aMphQkcGtpHixwwhAXJT1rrK/detk2JIvDaFkLctbGM= github.com/docker/cli v27.5.0+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8= +github.com/docker/cli v27.5.1+incompatible h1:JB9cieUT9YNiMITtIsguaN55PLOHhBSz3LKVc6cqWaY= +github.com/docker/cli v27.5.1+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8= github.com/docker/compose-cli v1.0.35 h1:uZyEHLalfqBS2PiTpA1LAULyJmuQ+YtZg7nG4Xl3/Cc= github.com/docker/compose-cli v1.0.35/go.mod h1:mSXI4hFLpRU3EtI8NTo32bNwI0UXSr8jnq+/rYjGAUU= github.com/docker/compose/v2 v2.22.0 h1:3rRz4L7tPU75wRsV8JZh2/aTgerQvPa1cpzZN+tHqUY= From c6d97fea62b79cf78e0b37d2cd8a43ae927061d0 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Mon, 27 Jan 2025 13:28:43 +0100 Subject: [PATCH 4/4] engine: bump latest engine version Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- hugo.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/hugo.yaml b/hugo.yaml index 36c6795f4666..316ac97a8065 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -113,10 +113,10 @@ params: # Latest version of the Docker Engine API latest_engine_api_version: "1.47" # Latest version of Docker Engine - docker_ce_version: "27.5.0" + docker_ce_version: "27.5.1" # Previous version of the Docker Engine # (Used to show e.g., "latest" and "latest"-1 in engine install examples - docker_ce_version_prev: "27.4.1" + docker_ce_version_prev: "27.5.0" # Latest Docker Compose version compose_version: "v2.32.4" # Latest BuildKit version