Name | Date | Size | #Lines | LOC | ||
---|---|---|---|---|---|---|
.. | 03-May-2022 | - | ||||
.github/ | H | 10-Apr-2019 | - | 8 | 4 | |
components/ | H | 10-Apr-2019 | - | 2,359,059 | 1,883,240 | |
.gitignore | H A D | 10-Apr-2019 | 46 | 5 | 4 | |
CHANGELOG.md | H A D | 10-Apr-2019 | 18.2 KiB | 243 | 164 | |
CONTRIBUTING.md | H A D | 10-Apr-2019 | 5.2 KiB | 126 | 89 | |
Makefile | H A D | 10-Apr-2019 | 2 KiB | 57 | 44 | |
README.md | H A D | 10-Apr-2019 | 3.5 KiB | 95 | 69 | |
VERSION | H A D | 10-Apr-2019 | 8 | 2 | 1 | |
components.conf | H A D | 10-Apr-2019 | 229 | 10 | 9 |
README.md
1# Docker CE 2 3This repository hosts open source components of Docker CE products. The 4`master` branch serves to unify the upstream components on a regular 5basis. Long-lived release branches host the code that goes into a product 6version for the lifetime of the product. 7 8This repository is solely maintained by Docker, Inc. 9 10## Issues 11 12There are separate issue-tracking repos for the end user Docker CE 13products specialized for a platform. Find your issue or file a new issue 14for the platform you are using: 15 16* https://github.com/docker/for-linux 17* https://github.com/docker/for-mac 18* https://github.com/docker/for-win 19* https://github.com/docker/for-aws 20* https://github.com/docker/for-azure 21 22## Unifying upstream sources 23 24The `master` branch is a combination of components adapted from 25different upstream git repos into a unified directory structure using the 26[moby-components](https://github.com/shykes/moby-extras/blob/master/cmd/moby-components) 27tool. 28 29You can view the upstream git repos in the 30[components.conf](components.conf) file. Each component is isolated into 31its own directory under the [components](components) directory. 32 33The tool will import each component git history within the appropriate path. 34 35For example, this shows a commit 36is imported into the component `engine` from 37[moby/moby@a27b4b8](https://github.com/moby/moby/commit/a27b4b8cb8e838d03a99b6d2b30f76bdaf2f9e5d) 38into the `components/engine` directory. 39 40``` 41commit 5c70746915d4589a692cbe50a43cf619ed0b7152 42Author: Andrea Luzzardi <aluzzardi@gmail.com> 43Date: Sat Jan 19 00:13:39 2013 44 45 Initial commit 46 Upstream-commit: a27b4b8cb8e838d03a99b6d2b30f76bdaf2f9e5d 47 Component: engine 48 49 components/engine/container.go | 203 ++++++++++++++++++++++++++++... 50 components/engine/container_test.go | 186 ++++++++++++++++++++++++++++... 51 components/engine/docker.go | 112 ++++++++++++++++++++++++++++... 52 components/engine/docker_test.go | 175 ++++++++++++++++++++++++++++... 53 components/engine/filesystem.go | 52 ++++++++++++++++++++++++++++... 54 components/engine/filesystem_test.go | 35 +++++++++++++++++++++++++++ 55 components/engine/lxc_template.go | 94 ++++++++++++++++++++++++++++... 56 components/engine/state.go | 48 ++++++++++++++++++++++++++++... 57 components/engine/utils.go | 115 ++++++++++++++++++++++++++++... 58 components/engine/utils_test.go | 126 ++++++++++++++++++++++++++++... 59 10 files changed, 1146 insertions(+) 60``` 61 62## Updates to `master` branch 63 64Main development of new features should be directed towards the upstream 65git repos. The `master` branch of this repo will periodically pull in new 66changes from upstream to provide a point for integration. 67 68## Branching for release 69 70When a release is started for Docker CE, a new branch will be created 71from `master`. Branch names will be `YY.MM` to represent the time-based 72release version of the product, e.g. `17.06`. 73 74## Adding fixes to release branch 75 76Note: every commit of a fix should affect files only within one component 77directory. 78 79### Fix available upstream 80 81A PR cherry-picking the necessary commits should be created against 82the release branch. If the the cherry-pick cannot be applied cleanly, 83the logic of the fix should be ported manually. 84 85### No fix yet 86 87First create the PR with the fix for the release branch. Once the fix has 88been merged, be sure to port the fix to the respective upstream git repo. 89 90## Release tags 91 92There will be a git tag for each release candidate (RC) and general 93availablilty (GA) release. The tag will only point to commits on release 94branches. 95