← ClaudeAtlas

cloudflare_ship_workerlisted

Ship a Cloudflare Worker correctly — configure wrangler, set bindings and secrets, run a dry-run, deploy, and verify.
Tarekkharsa/agentstack · ★ 2 · DevOps & Infrastructure · score 75
Install: claude install-skill Tarekkharsa/agentstack
# Ship a Cloudflare Worker > Unofficial, agentstack-authored. Not affiliated with or endorsed by Cloudflare. Use this skill when deploying a Cloudflare Worker (new or existing) and you want the deploy to be repeatable, reviewable, and safe to roll back. ## Workflow 1. Read `wrangler.toml` (or `wrangler.jsonc`) end to end. Confirm `name`, `main` (the entry script), and `compatibility_date` are set. A missing or stale `compatibility_date` is the most common cause of surprising runtime behavior — set it to the day you are shipping unless the project pins one deliberately. 2. Inventory every binding the Worker needs and confirm it exists in config: KV namespaces, R2 buckets, D1 databases, Queues, Durable Objects, service bindings, and `vars`. A binding referenced in code but absent from config fails at runtime, not at build. 3. Set secrets out of band with `wrangler secret put <NAME>` — never commit them to `wrangler.toml` or `vars`. Verify with `wrangler secret list`. 4. Validate before shipping: `wrangler deploy --dry-run --outdir dist` builds the bundle without publishing. Read the binding summary it prints and confirm it matches step 2. 5. Deploy to the intended environment explicitly: `wrangler deploy` for the default, or `wrangler deploy --env staging` / `--env production`. Do not let ambiguity decide which environment ships. 6. Verify the live deploy: hit the route or `workers.dev` URL, then tail logs with `wrangler tail` to confi