Release 2.9.0

[flxbk]

This issue is tracking the progress of the release 2.9.0. The release candidate is scheduled for the week of 5th June 2023.

Publish the release candidate

• Begin drafting the release notes: Draft release notes for Mimir 2.9.0 #5122
  • Create the release notes PR targeting the main branch
  • This step shouldn't block from publishing release candidate
  • After the release notes PR is merged (which usually happen after RC is published), cherry-pick them into the release branch
• Wait for any open PR we want to get merged before cutting the release candidate
  • We shouldn't wait for the open PRs beyond the scheduled release date
  • Eventually open a PR for every experimental feature we want to promote to stable: Promote some experimental features to stable for release 2.9 #5128
  • Eventually open a PR to remove any deprecated feature or configuration option that should be removed in this release: Remove deprecated flags for release 2.9 #5123
• Update CHANGELOG.md
  • Run ./tools/release/check-changelog.sh LAST-RELEASE-TAG...main and add missing PRs to CHANGELOG: Add missing entries for 2.9 to CHANGELOG.md #5127
  • Ensure CHANGELOG entries are sorted by type
  • Add a new section for the new release so that ## main / unreleased is blank and at the top. The new section should say ## x.y.0-rc.0. Cut changelog for Mimir 2.9 #5167
• Run ./tools/release/notify-changelog-cut.sh
• Run make mixin-screenshots Add dashboard screenshots for Mimir 2.9 #5168
  • Before opening the PR, review all updated screenshots and ensure no sensitive data is disclosed
• Create new release branch
  • Create the branch

    git checkout r<xxx> # xxx is the latest weekly release
    git checkout -b release-<version>
    git push -u origin release-<version>

  • Remove "main / unreleased" section from the CHANGELOG Update VERSION to 2.9.0-rc.0 #5169 Bump version to 2.9.0-rc.1 #5222
• Publish the Mimir release candidate
  • Update VERSION in the release branch and update CHANGELOG with version and release date.
    • Keep in mind this is a release candidate, so the version string in VERSION and CHANGELOG must end in -rc.#, where # is the release candidate number, starting at 0.
  • Tag the release

    git checkout release-<version>
    ./tools/release/tag-release.sh

  • Wait until the CI pipeline succeeds
  • Create a pre-release on GitHub

    git checkout release-<version>
    ./tools/release/create-draft-release.sh

  • Merge the release branch release- into main

    ./tools/release/create-pr-to-merge-release-branch-to-main.sh

  • Publish the Github pre-release draft after getting review from at least one maintainer
  • Announce the release candidate on social media such as on Mimir community slack using your own Twitter, Mastodon or LinkedIn account

Publish the stable release

• Publish the Mimir stable release
  • Write release notes
    • Ensure the any change to release notes in main has been cherry picked to the release branch
  • Update version in release- branch Bump version to 2.9.0 #5289
    • VERSION
    • CHANGELOG
    • operations/mimir/images.libsonnet (_images.mimir and _images.query_tee fields)
    • operations/mimir-rules-action/Dockerfile (grafana/mimirtool image tag)
  • Tag the release

    git checkout release-<version>
    ./tools/release/tag-release.sh

  • Wait until the CI pipeline succeeds
  • Create a release on GitHub

    git checkout release-<version>
    ./tools/release/create-draft-release.sh

  • Merge the release branch release- into main

    ./tools/release/create-pr-to-merge-release-branch-to-main.sh

  • Announce the release on socials
  • Open a PR to add the new version to the backward compatibility integration test (integration/backward_compatibility_test.go)
  • Publish dashboards to grafana.com

[rakshith-ravi]

The release candidate is scheduled for the week of 29th April 2023.

Is this a typo or is this release behind schedule? Also, any idea when this release would be published? We will be able to plan our updates to our users accordingly

[flxbk]

Is this a typo or is this release behind schedule?

That is indeed a typo, thanks for pointing it out.

Also, any idea when this release would be published?

We're planning to publish a first release candidate this week, but there might be a slight delay as we're looking to base it on the latest Go security fixes that are due tomorrow.

[fayzal-g]

Will need to release a patch with the CVE fix from #6569

[fayzal-g]

2.9.3 has now been released: https://github.com/grafana/mimir/releases/tag/mimir-2.9.3