Skip to content

Release Butane 0.23.0 #550

@yasminvalim

Description

@yasminvalim

Release checklist:

Tagging:

  • Write release notes in docs/release-notes.md. Get them reviewed and merged
    • If the release signing key has changed because a new Fedora release has gone stable, note the change as done here.
    • If doing a branched release, also include a PR to merge the docs/release-notes.md changes into main
  • Ensure your local copy is up to date with the upstream main branch (git@github.com:coreos/butane.git)
  • Ensure your working directory is clean (git clean -fdx)
  • Ensure you can sign commits and any yubikeys/smartcards are plugged in
  • Run ./tag_release.sh <vX.Y.z> <git commit hash>
  • Push that tag to GitHub

Fedora packaging:

  • Update the spec file in Fedora:
    • Bump the Version
    • Switch the Release back to 1%{?dist}
    • Remove any patches obsoleted by the new release
    • Run go-mods-to-bundled-provides.py | sort while inside of the butane directory you ran ./tag_release from & copy output into spec file in # Main package provides section
    • Update changelog
  • Run spectool -g -S butane.spec
  • Run kinit your_fas_account@FEDORAPROJECT.ORG
  • Run fedpkg new-sources $(spectool -S butane.spec | sed 's:.*/::')
  • PR the changes in Fedora
  • Once the PR merges to rawhide, merge rawhide into the other relevant branches (e.g. f40) then push those, for example:
    git checkout rawhide
    git pull --ff-only
    git checkout f40
    git merge --ff-only rawhide
    git push origin f40
  • On each of those branches run fedpkg build including rawhide.
  • Once the builds have finished, submit them to bodhi, filling in:
    • butane for Packages
    • Selecting the build(s) that just completed, except for the rawhide one (which gets submitted automatically)
    • Writing brief release notes like "New upstream release; see release notes at link to docs/release-notes.md on GH tag"
    • Leave Update name blank
    • Type, Severity and Suggestion can be left as unspecified unless it is a security release. In that case select security with the appropriate severity.
    • Stable karma and Unstable karma can be set to 2 and -1, respectively.

GitHub release:

  • Wait until the Bodhi update shows "Signed ✔️" in the Metadata box.
  • Verify that the signing script can fetch the release binaries by running ./signing-ticket.sh test <x.y.z-r> <output-dir>, where r is the Release of the Fedora package without the dist tag (probably 1)
  • Run ./signing-ticket.sh ticket <x.y.z-r> and paste the output into a releng ticket.
  • Wait for the ticket to be closed
  • Download the artifacts and signatures
  • Verify the signatures
  • Find the new tag in the GitHub tag list and click the triple dots menu, and create a draft release for it.
  • Copy and paste the release notes from docs/release-notes.md
  • Upload all the release artifacts and their signatures
  • Publish the release

Quay release:

  • Visit the Quay tags page and wait for a versioned tag to appear
  • Click the gear next to the tag, select "Add New Tag", enter release, and confirm
  • Visit the Quay tags page for the legacy coreos/fcct repo and wait for a versioned tag to appear
  • Click the gear next to the tag, select "Add New Tag", enter release, and confirm

NOT REQUIRED FOR BUTANE 0.23.0
RHCOS packaging for the current RHCOS development release:

  • Update the spec file
    • Bump the Version
    • Switch the Release back to 1%{?dist}
    • Remove any patches obsoleted by the new release
    • Run go-mods-to-bundled-provides.py | sort while inside of the butane directory you ran ./tag_release from & copy output into spec file in # Main package provides section
    • Update changelog
  • Run spectool -g -S butane.spec
  • Run kinit your_account@IPA.REDHAT.COM
  • Run rhpkg new-sources $(spectool -S butane.spec | sed 's:.*/::')
  • PR the changes
  • Get the PR reviewed and merge it
  • Update your local repo and run rhpkg build
  • File ticket similar to this one to sync the new version to mirror.openshift.com
  • Wait until mirror.openshift.com is updated and confirm the new version is correct

CentOS Stream 9 packaging:

  • Create a rebase-c9s-butane issue in the internal team-operations repo and follow the steps there

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions