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
   • create public custom query with target version set, sorted by status ascending, then priority descending
8. Announce beginning of bug-squashing to foreman-dev (example)
9. Copy website manual content (theforeman.org repo) from previous version to this version (example)
10. Update manual if applicable for any additional installation steps
11. 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
12. Check git log for any changes without associated bug number and add to release notes if applicable
13. Request creation of tags and build targets in Koji from rel-eng (foreman-1.2-rhel6 etc.) as clones of nightly tags

Pre-release candidates¶

When ready to branch for release candidates.

1. In foreman, smart-proxy and foreman-installer, branch develop to 1.2-stable
   • cherry-picks into this branch only from this point using: git cherry-pick -x SHA
2. In foreman develop commit with message "Bump version to 1.2-develop":
   1. change to VERSION to 1.2-develop
   2. change foreman.spec to 1.2.9999, add %25changelog entry
   3. run extras/changelog
   4. run rake locale:find
3. In smart-proxy develop commit with message "Bump version to 1.2-develop":
   1. change to lib/proxy.rb VERSION to 1.2-develop
   2. change foreman-proxy.spec version to 1.2.9999, add %25changelog entry
   3. run extra/changelog
4. Update foreman-dev with translations status to encourage 100%25 translations before release, announce string freeze date
5. Update $repo in both foreman-installer/foreman and foreman_proxy modules to "rc" (example)
6. Set up test_1_2_stable job on Jenkins, copy from existing stable or test_develop (don't use dots in the name, it breaks)

For each release candidate¶

1. Update version and dependency versions in all foreman-installer submodules
2. Update submodules on foreman-installer's develop branch
3. In foreman 1.2-stable commit with message "Release 1.2.0-RC1":
   1. change to VERSION to 1.2.0-RC1
   2. change foreman.spec version to "1.2.0", release to "0.1.RC1", add %25changelog entry
   3. run extras/changelog
   4. run rake locale:find if before string freeze
4. In smart-proxy 1.2-stable commit with message "Release 1.2.0-RC1":
   1. change to lib/proxy.rb VERSION to 1.2.0-RC1
   2. change foreman-proxy.spec version to "1.2.0", release to "0.1.RC1", add %25changelog entry
   3. run extra/changelog
5. Tag commits in foreman, smart-proxy and foreman-installer as 1.2.0-RC1
6. Perform scratch build of foreman and foreman-proxy
7. `git push && git push --tags`
8. Clone new repo and follow tag and release procedure for foreman and foreman-proxy (see RPM_Packaging)
9. FIXME: update Debian build script with tag and trigger Debian build
10. Build foreman-installer modules from develop (see Installer_Packaging workflow)
11. Build foreman-installer RPM and Debian packages from develop (see RPM_Packaging and Debian_Packaging)

For final release¶

1. Update version and dependency versions in all foreman-installer submodules
2. Revert $repo in both foreman-installer/foreman and foreman_proxy modules to "stable" (example)
3. Update submodules on foreman-installer's develop branch
4. Merge foreman-installer's develop branch into master
5. Build foreman-installer modules from master (see Installer_Packaging workflow)
6. Build foreman-installer RPM and Debian packages from master (see RPM_Packaging and Debian_Packaging)