Publication of Galaxy Release v 24.1.0

[jdavcs]

• Prep

  • Create this release issue make release-issue.
  • Set freeze date (2024-05-20).
  • Verify that your installed version of galaxy-release-util is up-to-date.

• Branch Release (on or around 2024-05-20)

  • Ensure all blocking milestone pull requests have been merged, delayed, or closed.

    make release-check-blocking-prs
    

  • Add latest database revision identifier (for release_24.1.0 and 24.1.0) to REVISION_TAGS in galaxy/model/migrations/dbscript.py.

  • Merge the latest release into dev and push upstream.

    make release-merge-stable-to-next RELEASE_PREVIOUS=release_24.0
    make release-push-dev
    

  • Create and push release branch:

    make release-create-rc
    

  • Open pull requests from your fork of branch version-24.1.0 to upstream release_24.1.0 and of version-24.2.dev to dev.

  • Update MILESTONE_NUMBER in the maintenance bot to 24.2 so it properly tags new pull requests.

• Issue Review Timeline Notes

  • Ensure any security fixes will be ready prior to 2024-05-20 + 1 week, to allow time for notification prior to release.
  • Ensure ownership of outstanding bugfixes and track progress during freeze.

• Deploy and Test Release

  • Update test.galaxyproject.org to ensure it is running the release_24.1.0 branch.
  • Update testtoolshed.g2.bx.psu.edu to ensure it is running a dev at or past branch point (2024-05-20 + 1 day).
  • Conduct release testing on test.galaxyproject.org.
  • Deploy to usegalaxy.org (2024-05-20 + 1 week).
  • Deploy to toolshed.g2.bx.psu.edu (2024-05-20 + 1 week).
  • Conduct release testing on usegalaxy.org.
  • Update BioBlend CI testing to include a release_24.1.0 target: add - release_24.1.0 to the galaxy_version list in .github/workflows/test.yaml .
  • Update GALAXY_RELEASE in IUC and devteam github workflows
    • https://github.com/galaxyproject/tools-iuc/blob/master/.github/workflows/
    • https://github.com/galaxyproject/tools-devteam/blob/master/.github/workflows/

• Create Release Notes

  • Review merged pull requests and ensure they all have a milestone attached. Link

  • Switch to release branch and create a new branch for release notes

    git checkout release_24.1.0 -b 24.1.0_release_notes
    

  • Bootstrap the release notes

    make release-bootstrap-history RELEASE_CURR=24.1.0
    

  • Open newly created files and manually curate major topics and release notes.

  • Run python scripts/release-diff.py release_24.0 and add configuration changes to release notes.

  • Add new release to doc/source/releases/index.rst

  • Open a pull request for the release notes branch.

  • Merge release notes pull request.

• Do Release

  • Ensure all blocking milestone issues have been resolved.

    make release-check-blocking-issues RELEASE_CURR=24.1.0
    

  • Ensure all blocking milestone pull requests have been merged or closed.

    make release-check-blocking-prs RELEASE_CURR=24.1.0
    

  • Ensure all pull requests merged into the pre-release branch during the freeze have milestones attached and that they are the not 24.2 milestones

  • Ensure release notes include all pull requests added during the freeze by re-running the release note bootstrapping:

    make release-bootstrap-history
    

  • Ensure previous release is merged into current. GitHub branch comparison

  • Create and push release tag:

    make release-create
    

  • Create dev packages:

    cd packages && ./build_packages.sh
    

  • Create the first point release (v24.1.0.0) using the instructions at https://docs.galaxyproject.org/en/master/dev/create_point_release.html

  • Open PR against planemo with a pin to the new packages

• Announce Release

  • Verify release included in https://docs.galaxyproject.org/en/master/releases/index.html.
  • Review announcement in https://github.com/galaxyproject/galaxy/blob/dev/doc/source/releases/24.1.0_announce.rst.
  • Announce release on Galaxy Hub as a news content item. An example.
  • Post announcement to Galaxy Help. An example.
  • Announce release on Galaxy's social media accounts (Bluesky, Mastodon, LinkedIn).
  • Email announcement to galaxy-dev and galaxy-announce @lists.galaxyproject.org. An example.
  • Adjust http://getgalaxy.org text and links to match current master branch by opening a PR at https://github.com/galaxyproject/galaxy-hub/

• Prepare for next release

  • Close milestone 24.1.0 and ensure milestone 24.2 exists.
  • Create release issue for next version make release-issue.
  • Schedule committer meeting to discuss re-alignment of priorities.
  • Close this issue.