1# Configuration
2 
3## Dispatch Namespace Binding
4 
5### wrangler.jsonc
6```jsonc
7{
8  "$schema": "./node_modules/wrangler/config-schema.json",
9  "dispatch_namespaces": [{
10    "binding": "DISPATCHER",
11    "namespace": "production"
12  }]
13}
14```
15 
16## Worker Isolation Mode
17 
18Workers in a namespace run in **untrusted mode** by default for security:
19- No access to `request.cf` object
20- Isolated cache per Worker (no shared cache)
21- `caches.default` disabled
22 
23### Enable Trusted Mode
24 
25For internal platforms where you control all code:
26 
27```bash
28curl -X PUT \
29  "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/workers/dispatch/namespaces/$NAMESPACE" \
30  -H "Authorization: Bearer $API_TOKEN" \
31  -d '{"name": "'$NAMESPACE'", "trusted_workers": true}'
32```
33 
34**Caveats:**
35- Workers share cache within namespace (use cache key prefixes: `customer-${id}:${key}`)
36- `request.cf` object accessible
37- Redeploy existing Workers after enabling trusted mode
38 
39**When to use:** Internal platforms, A/B testing platforms, need geolocation data
40 
41 
42### With Outbound Worker
43```jsonc
44{
45  "dispatch_namespaces": [{
46    "binding": "DISPATCHER",
47    "namespace": "production",
48    "outbound": {
49      "service": "outbound-worker",
50      "parameters": ["customer_context"]
51    }
52  }]
53}
54```
55 
56## Wrangler Commands
57 
58```bash
59wrangler dispatch-namespace list
60wrangler dispatch-namespace get production
61wrangler dispatch-namespace create production
62wrangler dispatch-namespace delete staging
63wrangler dispatch-namespace rename old new
64```
65 
66## Custom Limits
67 
68Set CPU time and subrequest limits per invocation:
69 
70```typescript
71const userWorker = env.DISPATCHER.get(
72  workerName,
73  {},
74  {
75    limits: { 
76      cpuMs: 10,        // Max CPU ms
77      subRequests: 5    // Max fetch() calls
78    }
79  }
80);
81```
82 
83Handle limit violations:
84```typescript
85try {
86  return await userWorker.fetch(request);
87} catch (e) {
88  if (e.message.includes("CPU time limit")) {
89    return new Response("CPU limit exceeded", { status: 429 });
90  }
91  throw e;
92}
93```
94 
95## Static Assets
96 
97Deploy HTML/CSS/images with Workers. See [api.md](./api.md#static-assets) for upload process.
98 
99### Wrangler
100```jsonc
101{
102  "name": "customer-site",
103  "main": "./src/index.js",
104  "assets": {
105    "directory": "./public",
106    "binding": "ASSETS"
107  }
108}
109```
110 
111```bash
112npx wrangler deploy --name customer-site --dispatch-namespace production
113```
114 
115### Dashboard Deployment
116 
117Alternative to CLI:
118 
1191. Upload Worker file in dashboard
1202. Add `--dispatch-namespace` flag: `wrangler deploy --dispatch-namespace production`
1213. Or configure in wrangler.jsonc under `dispatch_namespaces`
122 
123See [api.md](./api.md) for programmatic deployment via REST API or SDK.
124 
125## Tags
126 
127Organize/search Workers (max 8/script):
128 
129```bash
130# Set tags
131curl -X PUT ".../tags" -d '["customer-123", "pro", "production"]'
132 
133# Filter by tag
134curl ".../scripts?tags=production%3Ayes"
135 
136# Delete by tag
137curl -X DELETE ".../scripts?tags=customer-123%3Ayes"
138```
139 
140Common patterns: `customer-123`, `free|pro|enterprise`, `production|staging`
141 
142## Bindings
143 
144**Supported binding types:** 29 total including KV, D1, R2, Durable Objects, Analytics Engine, Service, Assets, Queue, Vectorize, Hyperdrive, Workflow, AI, Browser, and more.
145 
146Add via API metadata (see [api.md](./api.md#deploy-with-bindings)):
147```json
148{
149  "bindings": [
150    {"type": "kv_namespace", "name": "USER_KV", "namespace_id": "..."},
151    {"type": "r2_bucket", "name": "STORAGE", "bucket_name": "..."},
152    {"type": "d1", "name": "DB", "id": "..."}
153  ]
154}
155```
156 
157Preserve existing bindings:
158```json
159{
160  "bindings": [{"type": "r2_bucket", "name": "STORAGE", "bucket_name": "new"}],
161  "keep_bindings": ["kv_namespace", "d1"]  // Preserves existing bindings of these types
162}
163```
164 
165For complete binding type reference, see [bindings](../bindings/) documentation
166 
167See [README.md](./README.md), [api.md](./api.md), [patterns.md](./patterns.md), [gotchas.md](./gotchas.md)
168