Release 24.08.0

[cgrinds]

The week before the release

• [x] Ensure CI is green
• [x] Create release branch from main to freeze commits, like so:

  RELEASE=24.08.0
  git fetch origin
  git checkout origin/HEAD
  git switch --create release/$RELEASE
  git push origin release/$RELEASE

• [x] If any changes are made in the harvest autosupport repository, please update the harvest-metrics repository main branch with the latest asup_linux_amd64 binary. This binary can be generated using Jenkins with the following parameters:

Field	Value
VERSION	24.08.0
RELEASE	1
BRANCH	release/24.08.0
ASUP_MAKE_TARGET	production
DOCKER_PUBLISH	false
RUN_TEST	true
OVERWRITE_DOCKER_LATEST_TAG	false

• [x] Create a release branch for the harvest-metrics repo like so:

  RELEASE=24.08.0
  git clone https://github.com/NetApp/harvest-metrics.git
  cd harvest-metrics
  git checkout origin/HEAD
  git switch --create release/$RELEASE
  git push origin release/$RELEASE

• [x] Ensure all issues for the release are tagged with status/testme and unassigned. Use gh or the GitHub UI to do this.
• [x] Use the release issue burn down list to verify issues are fixed. Move status/testme issues to status/open or status/done
• [x] Ensure that the release is validated against NABox.
• [x] Ensure that the release is validated against FSX.
• [x] Use Jenkins to create release artifacts for test machines
• [x] Create changelog
  • [x] Draft a new release. Use v$RELEASE for the tag and pick the release/$RELEASE branch. Click the Generate release notes button and double check, at the bottom of the release notes, that the commits are across the correct range. For example: https://github.com/NetApp/harvest/compare/v22.11.1...v23.02.0
  • [x] Copy/paste the generated release notes and save them in a file pbpaste > ghrn_$RELEASE.md
  • [x] Generate draft release highlights by executing go run pkg/changelog/main.go new. This will create a file named releaseHighlights_$RELEASE.md. Edit that file to add content (example content)
  • [x] Ensure all notable features are highlighted
  • [x] Ensure any breaking changes are highlighted
  • [x] Ensure any deprecations are highlighted
  • [x] Generate changelog by running

    go run pkg/changelog/main.go --title $RELEASE --highlights releaseHighlights_$RELEASE.md -r ghrn_$RELEASE.md | pbcopy

  • [x] Open a PR against the release branch with the generated release notes for review
  • [x] PR approval

Update Metrics Documentation

bin/harvest generate metrics --poller POLLERNAME

• [x] Make sure docs look good and open a PR for review with docs/ontap-metrics.md changes

The day of the release

• [x] Create a new build from Jenkins (details)
  • [x] Click Build with Parameters and fill in the appropriate fields. Here's an example, where RELEASE=24.08.0

Field	Value
VERSION	24.08.0
RELEASE	1
BRANCH	release/24.08.0
ASUP_MAKE_TARGET	production
DOCKER_PUBLISH	true
RUN_TEST	true
OVERWRITE_DOCKER_LATEST_TAG	true

• [x] Draft a new release. Use v$RELEASE for the tag and pick the release/$RELEASE branch.
• [x] Type $RELEASE in the Release title text input
• [x] Open the CHANGELOG.md file, copy the single $RELEASE section at the top, and paste into the release notes text area.
• [x] Ensure the Set as the latest release checkbox is selected
• [x] Ensure the Create a discussion for this release checkbox is selected
• [x] Upload the artifacts from the Jenkins build above and attach to the release
• [x] Click Publish release button
• [x] Announce on Discord
• [x] Publish latest docs to netapp.github.io
  • [x] Make sure you're on the release branch git switch release/$RELEASE
  • [x] The documentation version selector uses the short form of the release, so 24.08 NOT 24.08.0

    mike deploy --push --update-aliases $SHORT latest

• [x] Merge release branch into main. The PR should use the chore: prefix