- follow semver (
MAJOR.MINOR.PATCH) - runtime package version lives in
cloudflare/package.json
cd cloudflare
npm run release:checkUpdate release docs:
- append
CHANGELOG.md - add upgrade notes in
docs/UPGRADE_GUIDE.md
From repository root:
git tag vX.Y.Z
git push origin vX.Y.ZTag pushes matching v* trigger:
- Cloudflare runtime
release:check - Pages dashboard
release:check - Draft GitHub Release with generated release notes
Workflow file:
.github/workflows/release-tag.yml
For manual staged deployment with a canary gate, use:
.github/workflows/canary-deploy.yml
Operator guidance:
- announce route/schedule contract changes explicitly
- update migration guidance for private overlays
- verify downstream private repos can rebase/merge cleanly