How to release a new Shopware version

Preparation

Upgrade.md

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

New version in the Shopware Business Platform (SBP)

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

Run package test pipeline

Make sure that the package testsuite is running and green. (To be moved to GitHub)

Manual package test

• 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

Release

• 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.