Release Process¶

For each major release (i.e. not patch releases), the project selects a "release nanny" who's responsible for taking the develop branch through to release.

Please amend these lists as you see free, and as you find what works and what doesn't work.

Pre-release¶

1. Select the release nanny
2. Ensure RPM and Debian nightly packages are in good shape and all RPM dependencies are up to date
3. Ensure Transifex project is up to date
4. Decide on the version number
5. If number has changed, update version number in redmine
6. Add next+1 anticipated version number to redmine under Settings, sharing "With subprojects"
7. Check roadmap and issue search (example)
   • reassign major features to next+1 version or remove version
   • assign relevant bugs to this upcoming release
   • multiple bugs can be managed using checkboxes and then right clicking on the boxes for a menu
8. Announce beginning of bug-squashing to foreman-dev (example)
9. Draft release notes in markdown (example) using roadmap, with these sections:
   1. Headline features: half a dozen important features with a few sentences description each
   2. Upgrade notes: all important notices that users must be aware of before upgrading
   3. Release notes: bullet point list by category of most changes, excluding bug fixes for issues introduced during the release cycle, include link to bug numbers
10. Check git log for any changes without associated bug number and add to release notes if applicable

Pre-release candidates¶

1. Request creation of tags and build targets in Koji from rel-eng (foreman-1.2-rhel6 etc.)
2. Branch develop to 1.2-stable, cherry-picks into this branch only from this point using:
   • git cherry-pick -x SHA
3. Commit change to VERSION in develop to 1.3 (next+1 version) and foreman.spec + foreman-proxy.spec to 1.3.9999 (next+1 version)
4. Re-tag all dependencies in Koji to the release tag (kkoji tag-pkg foreman-1.2-rhel6 PKG...)
5. Update foreman-dev with translations status to encourage 100%25 translations before release, announce string freeze date

For each release candidate¶

1. Commit change to VERSION in 1.2-stable to 1.2.0-RC1 and foreman.spec + foreman-proxy.spec version to 1.2.0 and release to RC1
2. Tag commit as 1.2.0-RC1
3. Perform scratch build and then tag and release real build of foreman and foreman-proxy
4. FIXME: update Debian build script with tag and trigger Debian build