Repository navigation
Overview
Workers Release Promoter is a production-focused GitHub Action for promoting Cloudflare Workers from GitHub Releases with operational safety and clear delivery records.
This release refines Marketplace readiness, release metadata quality, and developer-facing adoption details while preserving existing action behavior and workflow UX.
Key capabilities
- Release-driven deployment flow for Cloudflare Workers.
- Promotion strategies:
immediate,gradual, andstaging-only. - Two-phase smoke verification with optional custom smoke command execution.
- Automatic rollback with structured failure reporting.
- GitHub Release deployment annotations with configurable section handling.
Release annotation improvements
- Configurable update modes:
appendandreplace-section. - Configurable section heading via
deployment-section-heading. - Structured deployment record includes:
- Worker name
- Release tag and release ID
- Candidate version ID and deployment ID
- Staging and production URLs
- Promotion strategy and promotion result
- Smoke-test result
- Rollback information
- Timestamp
- Workflow run URL when available
Outputs for downstream workflows
The action publishes machine-readable outputs for deployment orchestration and integrations, including release context, deployment identifiers, URLs, smoke status, promotion status, and rollback metadata.
Packaging and versioning
- JavaScript action packaging remains committed under
dist/for consumer execution. - Runtime is declared via
action.ymlwithnode20. - Versioning follows immutable semantic tags plus a movable major channel:
- Immutable tag:
v1.0.1 - Major channel:
v1(updated to this release)
- Immutable tag:
Required workflow permissions
For full functionality, consumer workflows should grant:
contents: writefor GitHub Release annotation updatesdeployments: writefor deployment status reporting
Adoption quick start
Use the major channel for compatible updates:
uses: BotCoder254/cloudflare-promoter@v1
For strict supply-chain pinning, use an immutable tag or commit SHA.
Marketplace publication readiness
- Action metadata description now satisfies the Marketplace length constraint.
- Repository discovery tags were expanded for better searchability across GitHub surfaces.