release-train-issue-template.md

Release Akka Projections $VERSION$

Cutting the release

• Check that open PRs and issues assigned to the milestone are reasonable
• Update the Change date and version in the LICENSE file
• Update the Akka Projection version in the samples to $VERSION$, otherwise the published zip files of the samples will have the old version.
• When changing minor version, update Dependencies.AkkaProjectionVersionInDocs
• Create a new milestone for the next version
• Close the $VERSION$ milestone
• Make sure all important PRs have been merged
• For recent dependency updates or changes on a minor release branch the Fossa validation can be triggered from the GitHub actions "Dependency License Scanning" (Manually choosing the release branch)
• Update the revision in Fossa in the Akka Group for the Akka umbrella version, e.g. 22.10. Note that the revisions for the release is udpated by Akka Group > Projects > Edit.
• Wait until main build finished after merging the latest PR
• Update the draft release with the next tag version v$VERSION$, title and release description. Use the Publish release button, which will create the tag.
• Check that GitHub Actions release build has executed successfully (GitHub Actions will start a CI build for the new tag and publish artifacts to https://repo.akka.io/maven)

Check availability

• Check API documentation
• Check reference documentation. Check that the reference docs were deployed and show a version warning (see section below on how to fix the version warning).
• Check the release on https://repo.akka.io/maven/com/lightbend/akka/akka-projection-core_2.13/$VERSION$/akka-projection-core_2.13-$VERSION$.pom

When everything is on https://repo.akka.io/maven

• Log into gustav.akka.io as akkarepo
  • If this updates the current version, run ./update-akka-projection-current-version.sh $VERSION$
  • otherwise check changes and commit the new version to the local git repository

    cd ~/www
    git status
    git add libraries/akka-projection/current libraries/akka-projection/$VERSION$
    git add api/akka-projection/current api/akka-projection/$VERSION$
    git commit -m "Akka Projection $VERSION$"
    

Announcements

For important patch releases, and only if critical issues have been fixed:

• Send a release notification to Lightbend discuss
• Tweet using the @akkateam account (or ask someone to) about the new release
• Announce internally (with links to Tweet, discuss)

For minor or major releases:

• Include noteworthy features and improvements in Akka umbrella release announcement at akka.io. Coordinate with PM and marketing.

Afterwards

• Update akka-dependencies bom and version for Akka module versions in akka-dependencies repo
• Update Akka Guide samples
• Close this issue