A release of the whole SDK should be created at least every 2 weeks.
The SDK is split into all the different STACKIT services, each of them having their own version numbers.
Checklist before releasing a single service
- Changelog entries were added to the
CHANGELOG.mdin the root directory of the repository (see here) - Changelog entries were added to the
CHANGELOG.mdfile of the service to be released (see e.g. here)
Releasing a single service
- Update the VERSION file of the corresponding service
- When the PR is merged to main the tag is created automatically
Checklist before releasing the whole SDK
- Date was set/updated in the
CHANGELOG.mdfile in the root directory of the repository (see here)
Releasing the whole SDK
Important
Consider informing / syncing with the team before creating a new release.
- Check out latest main branch on your machine
- Create git tag:
git tag release-YYYY-MM-DD - Push the git tag:
git push origin --tags - Copy the changelog entries for the new release from the
CHANGELOG.mdfile in the root directory of the repository (see here) to your clipboard. - Go to the releases page on GitHub and create a new release. Select the git tag you just created.
- Before creating the GitHub release, add the Highlights heading at the top of the markdown description and paste the changelog entries from your clipboard (see previous releases to see what it should look like). Then create and publish the GitHub release.