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。
- 01先命名 contract
Cloudflare 現在建議新專案從 Workers 開始;Pages 留給既有專案,per-branch 迴圈改用 Worker Previews。
- 02只加入一個 primitive
在 Workers 上固定 build commands 與 runtime versions、在 previews 區塊宣告每個 Preview、把 KV、D1、R2 綁到各自的資源,再用 wrangler deploy 推上 production。既有 Pages 專案在遷移前仍用 wrangler pages deploy dist。
- 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
讓第一方來源保持權威
產品行為、限制、價格與供應狀態會改變;採取行動前請重新核對這些來源。