cloudflare · Cloudflare Workers Docs
Workers Gradual rollouts
Implements version affinity using Cloudflare Transform Rules to prevent 404 errors during gradual Worker deployments by ensuring users are pinned to a specific Worker version via session or user identifiers.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Workers Gradual rollouts
Implements version affinity using Cloudflare Transform Rules to prevent 404 errors during gradual Worker deployments by ensuring users are pinned to a specific Worker version via session or user identifiers.
When To Use
Use when deploying new versions of a Worker that serves fingerprinted static assets and you need to prevent users from receiving 404 errors caused by version mismatches between HTML and asset requests.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/workers-static-assets-routing-gradual-rollouts-workflow-guide.md | A guide explaining how to prevent asset mismatches during gradual Worker deployments using version, session, and user-based affinity. | Questions about a guide explaining how to prevent asset mismatches during gradual Worker deployments using version, session, and user... |
examples/workers-static-assets-routing-gradual-rollouts-cloudflare-workers-gradua.text | A text representation of the directory structure for a distribution folder used in Workers gradual rollouts, showing hashed asset filenames. | Exact payloads, commands, or snippets shown in A text representation of the directory structure for a distribution folder used in Workers gradual rollouts, showing... |
examples/workers-static-assets-routing-gradual-rollouts-cloudflare-workers-gradua-2.text | A text-based example of a routing rule using a cookie check to implement gradual rollouts in Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text-based example of a routing rule using a cookie check to implement gradual rollouts in Cloudflare Workers. |
examples/workers-static-assets-routing-gradual-rollouts-cloudflare-workers-gradua-3.text | A text-based example of a routing rule using an HTTP cookie condition to implement gradual rollouts in Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text-based example of a routing rule using an HTTP cookie condition to implement gradual rollouts in Cloudflare Wor... |
examples/workers-static-assets-routing-gradual-rollouts-cloudflare-workers-gradua-4.text | Curl commands demonstrating how to test version affinity during a gradual rollout using session cookies. | Exact payloads, commands, or snippets shown in Curl commands demonstrating how to test version affinity during a gradual rollout using session cookies. |
What This Skill Covers
- Gradual deployments route requests to different Worker versions based on configured percentages. When your Worker serves static assets, this per-request rout...
- Main sections:
Preventing asset mismatches with version affinity,Session-based affinity,User-based affinity,Testing and monitoring,Best practices.
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/static-assets/routing/advanced/gradual-rollouts