1# Resource Configuration
2 
3## Workers (cloudflare.WorkerScript)
4 
5```typescript
6import * as cloudflare from "@pulumi/cloudflare";
7import * as fs from "fs";
8 
9const worker = new cloudflare.WorkerScript("my-worker", {
10    accountId: accountId,
11    name: "my-worker",
12    content: fs.readFileSync("./dist/worker.js", "utf8"),
13    module: true, // ES modules
14    compatibilityDate: "2025-01-01",
15    compatibilityFlags: ["nodejs_compat"],
16    
17    // v6.x: Observability
18    logpush: true, // Enable Workers Logpush
19    tailConsumers: [{service: "log-consumer"}], // Stream logs to Worker
20    
21    // v6.x: Placement
22    placement: {mode: "smart"}, // Smart placement for latency optimization
23    
24    // Bindings
25    kvNamespaceBindings: [{name: "MY_KV", namespaceId: kv.id}],
26    r2BucketBindings: [{name: "MY_BUCKET", bucketName: bucket.name}],
27    d1DatabaseBindings: [{name: "DB", databaseId: db.id}],
28    queueBindings: [{name: "MY_QUEUE", queue: queue.id}],
29    serviceBindings: [{name: "OTHER_SERVICE", service: other.name}],
30    plainTextBindings: [{name: "ENV_VAR", text: "value"}],
31    secretTextBindings: [{name: "API_KEY", text: secret}],
32    
33    // v6.x: Advanced bindings
34    analyticsEngineBindings: [{name: "ANALYTICS", dataset: "my-dataset"}],
35    browserBinding: {name: "BROWSER"}, // Browser Rendering
36    aiBinding: {name: "AI"}, // Workers AI
37    hyperdriveBindings: [{name: "HYPERDRIVE", id: hyperdriveConfig.id}],
38});
39```
40 
41## Workers KV (cloudflare.WorkersKvNamespace)
42 
43```typescript
44const kv = new cloudflare.WorkersKvNamespace("my-kv", {
45    accountId: accountId,
46    title: "my-kv-namespace",
47});
48 
49// Write values
50const kvValue = new cloudflare.WorkersKvValue("config", {
51    accountId: accountId,
52    namespaceId: kv.id,
53    key: "config",
54    value: JSON.stringify({foo: "bar"}),
55});
56```
57 
58## R2 Buckets (cloudflare.R2Bucket)
59 
60```typescript
61const bucket = new cloudflare.R2Bucket("my-bucket", {
62    accountId: accountId,
63    name: "my-bucket",
64    location: "auto", // or "wnam", etc.
65});
66```
67 
68## D1 Databases (cloudflare.D1Database)
69 
70```typescript
71const db = new cloudflare.D1Database("my-db", {accountId, name: "my-database"});
72 
73// Migrations via wrangler
74import * as command from "@pulumi/command";
75const migration = new command.local.Command("d1-migration", {
76    create: pulumi.interpolate`wrangler d1 execute ${db.name} --file ./schema.sql`,
77}, {dependsOn: [db]});
78```
79 
80## Queues (cloudflare.Queue)
81 
82```typescript
83const queue = new cloudflare.Queue("my-queue", {accountId, name: "my-queue"});
84 
85// Producer
86const producer = new cloudflare.WorkerScript("producer", {
87    accountId, name: "producer", content: code,
88    queueBindings: [{name: "MY_QUEUE", queue: queue.id}],
89});
90 
91// Consumer
92const consumer = new cloudflare.WorkerScript("consumer", {
93    accountId, name: "consumer", content: code,
94    queueConsumers: [{queue: queue.name, maxBatchSize: 10, maxRetries: 3}],
95});
96```
97 
98## Pages Projects (cloudflare.PagesProject)
99 
100```typescript
101const pages = new cloudflare.PagesProject("my-site", {
102    accountId, name: "my-site", productionBranch: "main",
103    buildConfig: {buildCommand: "npm run build", destinationDir: "dist"},
104    source: {
105        type: "github",
106        config: {owner: "my-org", repoName: "my-repo", productionBranch: "main"},
107    },
108    deploymentConfigs: {
109        production: {
110            environmentVariables: {NODE_VERSION: "18"},
111            kvNamespaces: {MY_KV: kv.id},
112            d1Databases: {DB: db.id},
113        },
114    },
115});
116```
117 
118## DNS Records (cloudflare.DnsRecord)
119 
120```typescript
121const zone = cloudflare.getZone({name: "example.com"});
122const record = new cloudflare.DnsRecord("www", {
123    zoneId: zone.then(z => z.id), name: "www", type: "A",
124    content: "192.0.2.1", ttl: 3600, proxied: true,
125});
126```
127 
128## Workers Domains/Routes
129 
130```typescript
131// Route (pattern-based)
132const route = new cloudflare.WorkerRoute("my-route", {
133    zoneId: zoneId,
134    pattern: "example.com/api/*",
135    scriptName: worker.name,
136});
137 
138// Domain (dedicated subdomain)
139const domain = new cloudflare.WorkersDomain("my-domain", {
140    accountId: accountId,
141    hostname: "api.example.com",
142    service: worker.name,
143    zoneId: zoneId,
144});
145```
146 
147## Assets Configuration (v6.x)
148 
149Serve static assets from Workers:
150 
151```typescript
152const worker = new cloudflare.WorkerScript("app", {
153    accountId: accountId,
154    name: "my-app",
155    content: code,
156    assets: {
157        path: "./public", // Local directory
158        // Assets uploaded and served from Workers
159    },
160});
161```
162 
163## v6.x Versioned Deployments (Advanced)
164 
165For gradual rollouts, use 3-resource pattern:
166 
167```typescript
168// 1. Worker (container for versions)
169const worker = new cloudflare.Worker("api", {
170    accountId: accountId,
171    name: "api-worker",
172});
173 
174// 2. Version (immutable code + config)
175const version = new cloudflare.WorkerVersion("v1", {
176    accountId: accountId,
177    workerId: worker.id,
178    content: fs.readFileSync("./dist/worker.js", "utf8"),
179    compatibilityDate: "2025-01-01",
180    compatibilityFlags: ["nodejs_compat"],
181    // Note: Bindings configured at deployment level
182});
183 
184// 3. Deployment (version + bindings + traffic split)
185const deployment = new cloudflare.WorkersDeployment("prod", {
186    accountId: accountId,
187    workerId: worker.id,
188    versionId: version.id,
189    // Bindings applied to deployment
190    kvNamespaceBindings: [{name: "MY_KV", namespaceId: kv.id}],
191});
192```
193 
194**When to use:** Blue-green deployments, canary releases, gradual rollouts  
195**When NOT to use:** Simple single-version deployments (use WorkerScript)
196 
197---
198See: [README.md](./README.md), [api.md](./api.md), [patterns.md](./patterns.md), [gotchas.md](./gotchas.md)
199