Foreman 3.17.0-rc1 Release Process

[ogajduse]

This procedure was generated from procedures/foreman/release.md.erb at 480c10db5f12183c26d0d994533cc06e44cbcc48

Make this post a wiki (help)

Roles

• Release Owner: @ogajduse
• Release Engineer: @ogajduse

Preparing code: 2025-11-11

Release Owner

• Make sure any release blocking issues are resolved and remove/change target version field for any open Redmine tickets assigned to the release still (next minor, unset it or reject). Look for the 3.17.0 release TODO saved query on Foreman’s issues.
• Ensure that code in git matches issues fixed in 3.17.0-rc1 in Redmine. Use the 3.17.0 release DONE saved query on Foreman’s issues. issues can be used to generate a comparison between the two.
• Check for open pull requests in Foreman, smart-proxy, foreman-installer and foreman-selinux

Tagging a release: 2025-11-11

Release Owner

• Make sure foreman-3.17-stable-test and smart-proxy-3.17-stable-test are green using verify_green_jobs
• Run make -C locale tx-update in foreman 3.17-stable
• Tag the projects
  • Create tags using tag_project
  • Push tags using tag_push
• Run the Jenkins Tarballs Release using release_tarballs to create tarballs

Release Engineer

• Sign Tarballs
  • download_tarballs
  • inspect_tarballs
  • Sign and upload detached signatures using sign_tarballs

Note: If for some reason there was an issue with the tarballs that required uploading new tarballs, CDN cache should be invalidated so that the builders use the updated tarballs.

Packaging a release: 2025-11-11

Release Engineer

Background documentation

• Update foreman-packaging branches
  • rpm/3.17 using bump_rpm_packaging
  • deb/3.17 using bump_deb_packaging
• Wait for packages to be built using wait_packaging (checks rpm/3.17 and deb/3.17). This takes a while so you can already start on the manual updates.
• Check for outstanding PRs against 3.17 packaging, and merge if possible:
  • rpm/3.17
  • deb/3.17
• Sign the RPMs in the release
  • generate_stage_repository
  • sign_stage_rpms
  • upload_stage_rpms
• Sign RPMs for client repos (call scripts with PROJECT=client)
  • generate_stage_repository
  • sign_stage_rpms
  • upload_stage_rpms
• Kick off the release pipeline by calling release_pipeline
• Kick off the client pipeline by calling PROJECT=client ./release_pipeline
• Kick off the plugins pipeline by calling plugins_pipeline

Manual updates: 2025-11-11

Release Owner

• Update manual if applicable for any additional installation steps
• Update the website’s release notes section in the manual
  • Using the release notes script: ./scripts/release_notes.rb foreman 3.17.0
  • Append CLI release notes taken from the hammer-cli and hammer-cli-foreman changelogs, in theforeman.org.
  • Headline features: half a dozen important features with a few sentences description each
  • Upgrade warnings: all important notices that users must be aware of before upgrading
  • Deprecations: anything that will be removed in a future release
  • Submit this as a PR
• Update docs.theforeman.org
  • Using redmine_release_notes script (see README as well): ./guides/doc-Release_Notes/redmine_release_notes foreman 3.17.0 > ./guides/doc-Release_Notes/topics/foreman-3.17.0.adoc
  • Append CLI release notes taken from the hammer-cli and hammer-cli-foreman changelogs to foreman-3.17.0.adoc.
  • Add topics/foreman-3.17.0.adoc to guides/doc-Release_Notes/master.adoc: sed -i '/x.y.z releases here/a include::topics/foreman-3.17.0.adoc[leveloffset=+1]' guides/doc-Release_Notes/master.adoc
  • Make sure foreman-contributors.adoc is updated
  • Make sure headline features, upgrade warnings and deprecations are in sync with the website
  • Submit this as a PR
• Generate the apipie docs and raise pull request in apidocs repository

After the packages have been released

Release Owner

• Update theforeman.org
  • Update _config.yml
    • Add the 3.17 in foreman_versions list
• Add 3.17 to the navigation in docs.theforeman.org master
  • cp web/releases/nightly.adoc web/releases/3.17.adoc and modify as needed
  • cp web/releases/nightly.json web/releases/3.17.json and modify as needed
• Create a feedback post on Discourse (like Foreman 3.8 release candidate feedback )
• Announce the release on Discourse using release_announcement
• Update the topic in #theforeman channel on Matrix
• Release pipeline will trigger foreman-plugins-3.17-deb-test-pipeline and foreman-plugins-3.17-rpm-test-pipeline. These don’t block releases but can be used to understand known issues around plugin compatibility with Foreman 3.17.