Foreman 2.3 branching process

Make this post a wiki

Prep Week: 2020-10-19 to 2020-10-23

Installer Maintainer

Release Owner

  • Ensure headline features planned for the release have been merged or push them off to the next release.
  • Translations:

Stabilization Week: 2020-10-26 to 2020-10-30

Release Owner

Release Engineer

  • Create new GPG key for release. See GPG_Keys if needed.
  • Publish the key by exporting the GPG key
  • Create new settings files for client, ensure it has the rights OSES list and commit it too.
  • Create configs/foreman/2.3.yaml based on the nightly and previous release. Ensure that any based_on entries are filled out and pointing to nightly version of tag.
    • Generate mash configs
      bundle exec ./tools.rb mash-scripts configs/foreman/2.3.yaml
      sed -i '/strict_keys/ s/True/False/' mash_scripts/foreman/2.3.0/foreman-plugins-2.3-*.mash
      
    • Open PR with new config and mash scripts for review
    • Create mash configuration on Koji, from tool_belt checkout:
      scp mash_scripts/foreman/2.3.0/*.mash root@koji.katello.org:/etc/mash/
      
  • Update mash script if needed - collection-mash-split.py
  • Add the new release to the JJB job definitions in foreman-infra
    • Create a 2.3.groovy in pipelines/vars/foreman/ describing the operating systems the release supports
    • Add 2.3 to the version list in theforeman.org/yaml/includes/foreman_versions.yaml.inc
    • Add 2.3 to the version list in centos.org/jobs/foreman-pipelines.yml
    • Create test_2_3_stable.yaml and test_proxy_2_3_stable.yaml in yaml/jobs/
  • Open PR to remove any jobs that are related to end of life versions
  • Open PR to add 2.3 to Forklift versions config. Once the PR is merged, upgrade pipelines will fail, so do not merge it before packaging has been branched.

Branching: 2020-11-02

Release Engineer

  • Branch RPM packaging using tool_belt
    • Clone tags and create build targets in Koji: bundle exec ./tools.rb koji --commit configs/foreman/2.3.yaml
    • Create a rpm/2.3 branch in foreman-packaging based on rpm/develop
  • Branch Debian packaging

Release Owner

The next step should only be done after all branching, including packaging, has completed.

Preparing build systems: 2020-11-02

Release engineer

  • Update foreman-packaging rpm/develop to ensure nightlies build:
    • rpm/develop:
      • Update the build tag: sed -i 's/fm2_3/fm2_4/g' rel-eng/{releasers.conf,tito.props} package_manifest.yaml
      • Set to version 2.4.0, reset release to 1 in packages/foreman/foreman{,-{installer,proxy,release,selinux}}/*.spec and packages/foreman/rubygem-hammer_cli{,_foreman}/*.spec. Then create a changelog using obal changelog --message '- Bump version to 2.4-develop' foreman{,-{installer,proxy,release,selinux}} rubygem-hammer_cli{,_foreman}
    • deb/develop: scripts/changelog.rb -v 2.4.0-1 -m "Bump changelog to 2.4.0 to match VERSION" debian/*/*/changelog
  • Prepare build systems for 2.3 release:
    • foreman-packaging’s rpm/2.3
      • Update packages/foreman/foreman-release/foreman.gpg, mock/*.cfg, package_manifest.yaml, rel-eng/{releasers.conf,tito.props} and repoclosure/*.conf

Other systems: 2020-11-02

Release Owner

  • Create release schedule page for next version (2.4) linked from Development_Resources and post planned schedule on Discourse.
  • Create Redmine versions
    • Add next version number (2.4.0) and make sure it is shared with subprojects in foreman
    • Add first patch release (2.3.1) and make sure it is shared with subprojects in foreman
  • Ensure current Foreman deprecations for the next release are removed in develop Refactor #31233: Clean up deprecations for 2.4 - Foreman

This was based on the wiki procedure and sometimes has a bit more info.