01 / DECISION
この primitive を選ぶ時
Cloudflare は新規プロジェクトを Workers で始めるよう案内しています。Pages は既存プロジェクト向けとし、branch ごとのループは Worker Previews で構成します。
02 / ARCHITECTURE
最小で説明可能な path を作る
Workers では build command と runtime version を固定し、previews ブロックで各 Preview を宣言し、KV・D1・R2 は別リソースに bind して、production は wrangler deploy で出します。既存 Pages プロジェクトは移行まで wrangler pages deploy dist を使います。
- 01contract を定義
Cloudflare は新規プロジェクトを Workers で始めるよう案内しています。Pages は既存プロジェクト向けとし、branch ごとのループは Worker Previews で構成します。
- 02primitive を一つ追加
Workers では build command と runtime version を固定し、previews ブロックで各 Preview を宣言し、KV・D1・R2 は別リソースに bind して、production は wrangler deploy で出します。既存 Pages プロジェクトは移行まで wrangler pages deploy dist を使います。
- 03failure evidence を残す
preview URL、generated asset、canonical link、redirect、rollback を試し、production で同じ smoke check を再実行します。
03 / REPRODUCE
confidence の前に evidence
preview URL、generated asset、canonical link、redirect、rollback を試し、production で同じ smoke check を再実行します。
npx wrangler preview # existing Pages project: npx wrangler pages deploy dist04 / BOUNDARY
Production boundary
build 成功だけでは runtime integration、secret、redirect、header、custom-domain behavior は証明できません。Preview は production 設定を継承せず、KV・D1・R2 など account 単位のリソースは個別に bind した時だけ分離されます。
05 / FIRST-PARTY SOURCES
一次資料を authoritative に保つ
product behavior、limit、pricing、availability は変わります。実行前に source を再確認してください。