cloudflare · Cloudflare Workers Docs
Workers Gradual deployments
Teaches how to incrementally roll out code changes to Cloudflare Workers by splitting traffic between different versions using either the Wrangler CLI or the Cloudflare dashboard.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Workers Gradual deployments
Teaches how to incrementally roll out code changes to Cloudflare Workers by splitting traffic between different versions using either the Wrangler CLI or the Cloudflare dashboard.
When To Use
Use when you need to safely roll out new Worker code by gradually shifting traffic percentages and monitoring for errors before a full release.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/workers-configuration-versions-and-deployments-gradual-workflow-guide.md | A guide explaining how to incrementally shift traffic between Worker versions using gradual deployments and Wrangler. | Questions about a guide explaining how to incrementally shift traffic between Worker versions using gradual deployments and Wrangler. |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker.text | The npm command used to initialize a new Cloudflare Workers project for testing gradual deployments. | Exact payloads, commands, or snippets shown in The npm command used to initialize a new Cloudflare Workers project for testing gradual deployments. |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-2.text | A shell command demonstrating how to initialize a new Cloudflare Workers project using the create command. | Exact payloads, commands, or snippets shown in A shell command demonstrating how to initialize a new Cloudflare Workers project using the create command. |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-3.text | A command line instruction using pnpm to initialize a new Cloudflare Workers hello-world project for testing gradual deployments. | Exact payloads, commands, or snippets shown in A command line instruction using pnpm to initialize a new Cloudflare Workers hello-world project for testing gradual... |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-4.text | A text snippet demonstrating the npx wrangler versions upload command used for gradual deployments in Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text snippet demonstrating the npx wrangler versions upload command used for gradual deployments in Cloudflare Work... |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-5.text | A text snippet demonstrating the wrangler command used to upload a new version for gradual deployment in Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text snippet demonstrating the wrangler command used to upload a new version for gradual deployment in Cloudflare W... |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-6.text | A text snippet demonstrating the pnpm wrangler versions upload command used for gradual deployments in Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text snippet demonstrating the pnpm wrangler versions upload command used for gradual deployments in Cloudflare Wor... |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-7.text | A text snippet demonstrating the npx wrangler versions deploy command used for gradual deployments in Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text snippet demonstrating the npx wrangler versions deploy command used for gradual deployments in Cloudflare Work... |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-8.text | A text snippet demonstrating the wrangler command used to initiate a gradual deployment for Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text snippet demonstrating the wrangler command used to initiate a gradual deployment for Cloudflare Workers. |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-9.text | A text snippet demonstrating the pnpm wrangler versions deploy command used for gradual deployments in Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text snippet demonstrating the pnpm wrangler versions deploy command used for gradual deployments in Cloudflare Wor... |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-10.text | A bash loop script that uses curl to repeatedly request a Cloudflare Worker URL to observe gradual deployment traffic distribution. | Exact payloads, commands, or snippets shown in A bash loop script that uses curl to repeatedly request a Cloudflare Worker URL to observe gradual deployment traffic... |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-11.text | A curl command demonstrating how to request a specific worker version using the Cloudflare-Workers-Version-Key header. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to request a specific worker version using the Cloudflare-Workers-Version-Key header. |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-12.text | A text-based example of a routing rule using the starts_with function to manage gradual deployments in Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text-based example of a routing rule using the startswith function to manage gradual deployments in Cloudflare Work... |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-13.text | A curl command demonstrating how to use the Cloudflare-Workers-Version-Overrides header to target a specific worker version. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to use the Cloudflare-Workers-Version-Overrides header to target a specific worker v... |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-14.text | A text snippet demonstrating the npx wrangler deploy command used to initiate gradual deployments for Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text snippet demonstrating the npx wrangler deploy command used to initiate gradual deployments for Cloudflare Work... |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-15.text | A text snippet demonstrating the wrangler deploy command used to initiate gradual deployments for Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text snippet demonstrating the wrangler deploy command used to initiate gradual deployments for Cloudflare Workers. |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-16.text | A text snippet demonstrating the pnpm wrangler deploy command used to initiate gradual deployments in Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text snippet demonstrating the pnpm wrangler deploy command used to initiate gradual deployments in Cloudflare Work... |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-17.text | A curl command demonstrating how to create a Logpush job to monitor Workers trace events via the Cloudflare API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to create a Logpush job to monitor Workers trace events via the Cloudflare API. |
examples/workers-configuration-versions-and-deployments-gradual-cloudflare-worker-18.text | A text configuration example showing the scriptVersion object structure used for managing gradual deployments in Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text configuration example showing the scriptVersion object structure used for managing gradual deployments in Clou... |
What This Skill Covers
- Gradual Deployments give you the ability to incrementally deploy new versions of Workers by splitting traffic across versions.
- Main sections:
Use gradual deployments,Via Wrangler,1\. Create and deploy a new Worker,2\. Create a new version of the Worker,3\. Create a new deployment.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.cloudflare.com/workers/configuration/versions-and-deployments/gradual-deployments