diff --git a/content/manuals/cloud/index.md b/content/manuals/cloud/index.md deleted file mode 100644 index 7f65177807..0000000000 --- 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 ac668945ee..0000000000 --- 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 0000000000..17a6585432 --- /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)