Cloudflare Worldedge community field guide

CURRENT EDITION / 2026-09

Worker Previews:branch ごとに隔離された環境を一つ

各 branch は同じ Worker の下で独自の code、設定、URL、observability を持ちます。

ISSUE
33 / 34
初回公開
SOURCE CHECK
Archive integrity

edition month は curriculum 上の位置です。本 edition は 2026-09 に公開された一次資料をもとに執筆し、本文の初回公開日は 2026-10-21 です。retrospective run より後の edition は自身の公開日を持ちます。

01 / DECISION

この primitive を選ぶ時

Cloudflare は新規プロジェクトを Workers で始めるよう案内しているため、review ループを Workers-native にします。branch ごとに Preview を一つ用意し、実際に動かしてから production に上げます。

02 / ARCHITECTURE

最小で説明可能な path を作る

Wrangler 設定の previews ブロックで Preview の variable、binding、setting を宣言し、secret は Wrangler コマンドで適用し、KV・D1・R2 は別リソースに bind してから wrangler preview を実行するか、Workers Builds に pull request から Preview を作らせます。

  1. 01contract を定義

    Cloudflare は新規プロジェクトを Workers で始めるよう案内しているため、review ループを Workers-native にします。branch ごとに Preview を一つ用意し、実際に動かしてから production に上げます。

  2. 02primitive を一つ追加

    Wrangler 設定の previews ブロックで Preview の variable、binding、setting を宣言し、secret は Wrangler コマンドで適用し、KV・D1・R2 は別リソースに bind してから wrangler preview を実行するか、Workers Builds に pull request から Preview を作らせます。

  3. 03failure evidence を残す

    Preview URL に実際の traffic を送り、その Preview に属する log・error・metric・trace を読み、stable URL が最後の push を反映しているか確認し、production へ上げる前に自分が bind したリソースにだけ書き込んだかを検証します。

03 / REPRODUCE

confidence の前に evidence

Preview URL に実際の traffic を送り、その Preview に属する log・error・metric・trace を読み、stable URL が最後の push を反映しているか確認し、production へ上げる前に自分が bind したリソースにだけ書き込んだかを検証します。

npx wrangler preview   # requires Wrangler 4.135.0 or later

04 / BOUNDARY

Production boundary

Cloudflare は Preview ごとに Durable Object namespace と container instance を分けますが、KV・D1・R2 など account 単位のリソースは個別に bind した時だけ分離されます。Preview URL は既定で公開のため保護には Cloudflare Access が必要で、Preview 数は Worker ごとに Free 100、Paid 500 が上限、超過分は古いものから自動削除されます。

05 / FIRST-PARTY SOURCES

一次資料を authoritative に保つ

product behavior、limit、pricing、availability は変わります。実行前に source を再確認してください。

01 / SOURCEWorker Previewshttps://developers.cloudflare.com/workers/previews/02 / SOURCEWorker Previews changeloghttps://developers.cloudflare.com/changelog/post/2026-09-22-worker-previews/03 / SOURCECloudflare Pages: start new projects with Workershttps://developers.cloudflare.com/pages/