Skip to content

Latest commit

 

History

History
86 lines (64 loc) · 2.26 KB

RELEASE-CHECKLIST.md

File metadata and controls

86 lines (64 loc) · 2.26 KB
Raw

Release Checklist

1. Update version and CHANGELOG.md on docker/swarm

git checkout -b bump-<version>
edit version/version.go
edit CHANGELOG.md
git add .
git commit -s -m "Bump version to <version>"
git push $GITHUBUSER bump-<version>

Open PR on docker/swarm. Merge the PR before moving to next step. If the release is an RC, then CHANGELOG.md should list the latest RC.

If Go version is updated, please manually trigger dockerswarm/swarm-test-env build update at https://hub.docker.com/r/dockerswarm/swarm-test-env/~/dockerfile/. After successful build, Go version will be updated. This should be done whenever Go version is updated.

2. Rebase release branch on top of updated master branch and tag

git checkout master
git pull origin
git checkout release
git rebase master
git push origin
git tag <tag>
git push origin <tag>

The tag must be of the form v1.2.1-rc1.

3. Update library image

If you don't have github.com:docker/swarm-library-image.git repo, clone it.

git clone git@github.com:docker/swarm-library-image.git

Build and update Swarm image.

cd swarm-library-image
git pull
./update.sh <tag> (example: ./update.sh v0.2.0-rc2)
check build is successful (swarm binaries should show in git diff)
git add .
git commit -s -m “<tag>"
git push origin

4. Update official image

If you don't have https://github.com/docker-library/official-images.git, fork it.

git clone https://github.com/docker-library/official-images.git
cd official-images
git remote add $GITHUBUSER git@github.com:$GITHUBUSER/official-images.git

Update Swarm image list. You may add a new RC or a stable image to the image list. latest is for latest stable image, normally an RC doesn't qualify.

git checkout master
git pull
git checkout -b update_swarm_<tag>
edit library/swarm
git add library/swarm
git commit -s -m "update swarm <tag>"
git push $GITHUBUSER update_swarm_<tag>

Open PR on docker-library/official-images.

5. Create release on github

Go to https://github.com/docker/swarm/releases/new use <tag> and edit changelog.

Upload Linux binary to the release. Copy the image built at docker/swarm-library-image.

tar czvf swarm-#tag#-linux-x86_64.tgz swarm

In the release page, upload swarm-#tag#-linux-x86_64.tgz.