Difference between revisions of "TripleO/ReleaseManagement"

Revision as of 19:45, 10 April 2014

Prerequisites

1. Upload your GPG key to Launchpad
2. Become a member of tripleo-ptl ACL group in Gerrit

Projects

Currently, we make releases of the following projects on a regular basis:

• os-apply-config
• os-refresh-config
• os-collect-config
• diskimage-builder
• tripleo-heat-templates
• tripleo-image-elements
• tuskar
• python-tuskarclient

Versioning scheme

Generally, we follow the rules of Semantic Versioning, but as long as 1.0.0 version of a project hasn't been released, we use 0.MINOR.PATCH versioning scheme, bumping MINOR only when we do something incompatible with the previous release, and bumping PATCH part otherwise.

Stable Branches

We create stable branches under origin/stable for some projects. When a stable branch is ready to be cut, ask an OpenStack release manager to create the branches. Once the branches are created, a release should be done from the master branch that bumps the MINOR version (.Y) from the previous tag. This allows future releases out of the stable branch to bump the PATCH version (.Z) continually as needed.

We create stable branches for:

• tripleo-image-elements
• tripleo-heat-templates
• tuskar
• tripleo-incubator (Note we do not do releases of tripleo-incubator)

How to make a release

• Go to the project dir
• Update your clone

git remote update
git checkout master && git pull

• Find the version number of the last release among the other tags

git tag | sort --version-sort

• Find out what has changed since the last release

git log -u --no-merges $LAST_VERSION..HEAD

• Create a signed tag bumping the version number according to the versioning scheme described above

git tag -s X.Y.Z

• Verify the tag GPG signature

git tag -v $NEW_VERSION

• Push the created tag to Gerrit

git push gerrit $NEW_VERSION

• Use process_bugs util to close all the bugs which are in 'Fix committed' state. Note that tripleo-heat-templates and tripleo-image-elements do not have separate projects in launchpad and fall under the tripleo project instead. The bugs that are Fix Committed in tripleo should probably be manually double checked to make sure there were part of a release.

python process_bugs.py $PROJECT_NAME --fixrelease