Publication of Galaxy Release v 24.2

[jdavcs]

• Prep

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

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

  • Ensure all blocking milestone pull requests have been merged, closed, or postponed until the next release.

    make release-check-blocking-prs
    

  • Add latest database revision identifier (for release_24.2 and 24.2) 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.1
    make release-push-dev
    

  • Create and push release branch:

    make release-create-rc
    

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

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

• Issue Review Timeline Notes

  • Ensure any security fixes will be ready prior to 2024-11-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.2 branch.
  • Update testtoolshed.g2.bx.psu.edu to ensure it is running a dev at or past branch point (2024-11-20 + 1 day).
  • Conduct release testing on test.galaxyproject.org.
  • Deploy to usegalaxy.org (2024-11-20 + 1 week).
  • Deploy to toolshed.g2.bx.psu.edu (2024-11-20 + 1 week).
  • Conduct release testing on usegalaxy.org.
  • Update BioBlend CI testing to include a release_24.2 target: add - release_24.2 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.2 -b 24.2_release_notes
    

  • Bootstrap the release notes

    make release-bootstrap-history RELEASE_CURR=24.2
    

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

  • Run python scripts/release-diff.py release_24.1 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.2
    

  • Ensure all blocking milestone pull requests have been merged, closed, or postponed until the next release.

    make release-check-blocking-prs RELEASE_CURR=24.2
    

  • Ensure all pull requests merged into the pre-release branch during the freeze have milestones attached and that they are the not 25.0 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.2.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.2_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.2 and ensure milestone 25.0 exists.
  • Create release issue for next version make release-issue.
  • Schedule committer meeting to discuss re-alignment of priorities.
  • Close this issue.