How to release a new Shopware version

Preparation

Make sure that, the UPGRADE.md file is up-to-date and has the correct version

There should be at least a heading for each version with a link to the change from the version before. Example

Ping a Shopware employee, to create the new version in the SBP. This is needed for the extension store and plugin manufacturers.

Make sure that the package test suite is running and green.

Go to the 'create release package' job and start the workflow manually
Go to the 'create update package' job and start the workflow manually
Download the artifacts of both jobs
You may need to adjust the version manually in those places:
- engine/Shopware/Kernel.php
- recovery/install/data/version
Start manual testing

Create a new tag GIT_COMMITTER_DATE="$(git show --format=%aD | head -1)" git tag -s -a v5.7.20 -m "Tag version 5.7.20"
git push --tags

This will trigger the release workflow. After the action is finished, a new release is created as draft.

Go to the release page and open the edit mode of the draft release.

Press the button to create the changelog. Check the generated changelog and publish the release.

The action of the release cache should be executed, to make the release available for the auto-updater.