Deprecated integrations have been removed from this repository.
For historical reference, the complete code and documentation for these deprecated integrations is preserved in the deprecated-integrations-archive branch.
These rules apply to the published lambda packages under src/<name>/.
Metadata.AWS::ServerlessRepo::Application.SemanticVersionintemplate.yamlis the single source of truth for the published package version.- Bump
SemanticVersionwhenever a published package changes beyondCHANGELOG.md. - Do not try to reuse a previously published version number. AWS SAR versions are immutable, so fixes after a bad publish must ship as a new version on a new commit.
- Each published package must keep
src/<name>/CHANGELOG.md. - The first release heading must be
## [X.Y.Z] - YYYY-MM-DD. X.Y.Zin that first heading must matchtemplate.yamlSemanticVersion.- The top release entry must include at least one bullet describing the release.
- A changelog-only edit does not require a
SemanticVersionbump. - Use the
skip-changelogPR label only when a package change does not require a changelog entry or version bump.
- Merge to
masterdoes not publish by itself. - Promotion happens after merge by pushing a package release tag on the merged
mastercommit you want to release. - Accepted publish tags are
<name>-v<X.Y.Z>and<name>-<X.Y.Z>. - Both tag forms trigger the same single-package SAR publish workflow.
<name>-v<X.Y.Z>is the canonical outward release identity and the GitHub Release name.- If the bare alias tag is pushed first, the workflow backfills the canonical
<name>-v<X.Y.Z>tag and creates the GitHub Release there.
- Merge the package change to
master. - Validate the merged commit you intend to promote.
- Confirm
src/<name>/template.yamlSemanticVersionand the topsrc/<name>/CHANGELOG.mdentry both matchX.Y.Z. - Push either
git tag <name>-v<X.Y.Z>orgit tag <name>-<X.Y.Z>on that merged commit. - Run
git push origin <tag>to trigger the publish workflow.