Cloudflare Worldedge community field guide

回顧版月刊 / 2025-07

Pages:讓 preview 與 production 的差異清楚可見

Build output、environment、preview、promotion 與 rollback 才是完整 deployment product。

期號
19 / 34
首次發布
來源查核
檔案誠信

月份代表課程編排位置;本文屬於 32 期回顧版,首次發布於 2026-08-10,不冒充歷史發布紀錄或過往活動。

01 / DECISION

何時值得加入這個 primitive

Cloudflare 現在建議新專案從 Workers 開始;Pages 留給既有專案,per-branch 迴圈改用 Worker Previews。

02 / ARCHITECTURE

建立最小且站得住腳的路徑

在 Workers 上固定 build commands 與 runtime versions、在 previews 區塊宣告每個 Preview、把 KV、D1、R2 綁到各自的資源,再用 wrangler deploy 推上 production。既有 Pages 專案在遷移前仍用 wrangler pages deploy dist。

  1. 01先命名 contract

    Cloudflare 現在建議新專案從 Workers 開始;Pages 留給既有專案,per-branch 迴圈改用 Worker Previews。

  2. 02只加入一個 primitive

    在 Workers 上固定 build commands 與 runtime versions、在 previews 區塊宣告每個 Preview、把 KV、D1、R2 綁到各自的資源,再用 wrangler deploy 推上 production。既有 Pages 專案在遷移前仍用 wrangler pages deploy dist。

  3. 03保留 failure evidence

    測試 preview URL、generated asset set、canonical links、redirects 與 rollback,並在 production 重跑同一 smoke checks。

03 / REPRODUCE

有證據,再有信心

測試 preview URL、generated asset set、canonical links、redirects 與 rollback,並在 production 重跑同一 smoke checks。

npx wrangler preview   # existing Pages project: npx wrangler pages deploy dist

04 / BOUNDARY

Production boundary

Build 成功不代表 runtime integrations、secrets、redirects、headers 或 custom-domain behavior 正確。Preview 不會繼承 production 設定;KV、D1、R2 等 account 層級資源只有在各自綁定時才真的隔離。

05 / FIRST-PARTY SOURCES

讓第一方來源保持權威

產品行為、限制、價格與供應狀態會改變;採取行動前請重新核對這些來源。

01 / SOURCECloudflare Pageshttps://developers.cloudflare.com/pages/02 / SOURCEWorker Previewshttps://developers.cloudflare.com/workers/previews/03 / SOURCEMigrate from Pages to Workershttps://developers.cloudflare.com/workers/static-assets/migration-guides/migrate-from-pages/