16 Star 81 Fork 2

Gitee 极速下载 / docker

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
此仓库是为了提升国内下载速度的镜像仓库,每日同步一次。 原始仓库: https://github.com/docker/docker/
克隆/下载
VENDORING.md 1.91 KB
一键复制 编辑 原始数据 按行查看 历史

Vendoring policies

This document outlines recommended Vendoring policies for Docker repositories. (Example, libnetwork is a Docker repo and logrus is not.)

Vendoring using tags

Commit ID based vendoring provides little/no information about the updates vendored. To fix this, vendors will now require that repositories use annotated tags along with commit ids to snapshot commits. Annotated tags by themselves are not sufficient, since the same tag can be force updated to reference different commits.

Each tag should:

  • Follow Semantic Versioning rules (refer to section on "Semantic Versioning")
  • Have a corresponding entry in the change tracking document.

Each repo should:

  • Have a change tracking document between tags/releases. Ex: CHANGELOG.md, github releases file.

The goal here is for consuming repos to be able to use the tag version and changelog updates to determine whether the vendoring will cause any breaking or backward incompatible changes. This also means that repos can specify having dependency on a package of a specific version or greater up to the next major release, without encountering breaking changes.

Semantic Versioning

Annotated version tags should follow Semantic Versioning policies:

"Given a version number MAJOR.MINOR.PATCH, increment the:

  1. MAJOR version when you make incompatible API changes,
  2. MINOR version when you add functionality in a backwards-compatible manner, and
  3. PATCH version when you make backwards-compatible bug fixes.

Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format."

Vendoring cadence

In order to avoid huge vendoring changes, it is recommended to have a regular cadence for vendoring updates. e.g. monthly.

Pre-merge vendoring tests

All related repos will be vendored into docker/docker. CI on docker/docker should catch any breaking changes involving multiple repos.

Go
1
https://gitee.com/mirrors/docker.git
git@gitee.com:mirrors/docker.git
mirrors
docker
docker
master

搜索帮助