:warning: This repository is now deprecated and will be archived :warning:
Starting with the Docker 20.10 release, packages for the Docker Engine and Docker CLI are built directly from their respective source repositories instead of from this repository.
Practically this means: 1. This repository is no longer the “source of truth” for Docker CE builds. 2. The commit SHA and tag for Docker CLI build will come from the docker/cli repository and the commit SHA and tag for the Docker Engine will come from the moby/moby repository. 3. Release branches for the Engine, CLI, and packaging will be maintained on their respective repositories. 4. Updates will stop being made to this repository and it will be archived in the future. 5. Changelog is now Release Notes. 6. The
masterbranch of this repository will be emptied when the repository is archived.
This repository hosts open source components of Docker CE products. The
masterbranch serves to unify the upstream components on a regular basis. Long-lived release branches host the code that goes into a product version for the lifetime of the product.
This repository is solely maintained by Docker, Inc.
There are separate issue-tracking repos for the end user Docker CE products specialized for a platform. Find your issue or file a new issue for the platform you are using:
masterbranch is a combination of components adapted from different upstream git repos into a unified directory structure using the moby-components tool.
The tool will import each component git history within the appropriate path.
For example, this shows a commit is imported into the component
enginefrom moby/[email protected] into the
commit 5c70746915d4589a692cbe50a43cf619ed0b7152 Author: Andrea Luzzardi Date: Sat Jan 19 00:13:39 2013
Initial commit Upstream-commit: a27b4b8cb8e838d03a99b6d2b30f76bdaf2f9e5d Component: engine
components/engine/container.go | 203 ++++++++++++++++++++++++++++... components/engine/container_test.go | 186 ++++++++++++++++++++++++++++... components/engine/docker.go | 112 ++++++++++++++++++++++++++++... components/engine/docker_test.go | 175 ++++++++++++++++++++++++++++... components/engine/filesystem.go | 52 ++++++++++++++++++++++++++++... components/engine/filesystem_test.go | 35 +++++++++++++++++++++++++++ components/engine/lxc_template.go | 94 ++++++++++++++++++++++++++++... components/engine/state.go | 48 ++++++++++++++++++++++++++++... components/engine/utils.go | 115 ++++++++++++++++++++++++++++... components/engine/utils_test.go | 126 ++++++++++++++++++++++++++++... 10 files changed, 1146 insertions(+)
Main development of new features should be directed towards the upstream git repos. The
masterbranch of this repo will periodically pull in new changes from upstream to provide a point for integration.
When a release is started for Docker CE, a new branch will be created from
master. Branch names will be
YY.MMto represent the time-based release version of the product, e.g.
Note: every commit of a fix should affect files only within one component directory.
A PR cherry-picking the necessary commits should be created against the release branch. If the the cherry-pick cannot be applied cleanly, the logic of the fix should be ported manually.
First create the PR with the fix for the release branch. Once the fix has been merged, be sure to port the fix to the respective upstream git repo.
There will be a git tag for each release candidate (RC) and general availability (GA) release. The tag will only point to commits on release branches.