Skip to content
Sign in
Custom domain + server bindings

Custom domain + server bindings — rollout runbook

View raw
On this page

สถานะรวม: Phase 0–3 เสร็จ (deploy 2026-11-12) · Worker version 3faa0b9e-e07c-42a8-ba6d-7b46a8393f50 · D1 0024 ✅ · CUSTOM_DOMAINS_ENABLED=false (ship-dark) · Phase 4 pilot รอ smoke ภายใน

อ้างอิงทรัพยากร: CUSTOM-DOMAINS-CAPACITY-200.md · ฟีเจอร์: ../platform/CUSTOM-DOMAINS-HOSTING.md

Phase 0 — โค้ดบน main#

Step สถานะ หมายเหตุ
Merge cursor/custom-domains-server-bindings-c310 → main ✅ Fast-forward cf7536f
ลบสาขา feature ✅ cursor/custom-domains-server-bindings-c310
CUSTOM_DOMAINS_ENABLED / SERVER_BINDINGS_ENABLED = false ✅ Ship-dark

Phase 1 — ทดสอบบนเครื่อง#

Step คำสั่ง สถานะ
D1 local รวม 0024_project_domains_bindings.sql npm run db:migrate:local ✅
Lint / typecheck / tests / docs npm run lint && npm run typecheck && npm test && npm run docs:check รันก่อน deploy
cf build npm run cf:build รันก่อน deploy

Phase 2 — D1 production (ต้อง token บัญชี production)#

ลำดับ: migrate remote ก่อน deploy Worker ที่เรียก table ใหม่

bash
export CLOUDFLARE_ACCOUNT_ID=2d92bd5b25768fa9093d6adc0a8887fc
# ใช้ token ที่มี D1 migrate บนบัญชีนี้ (เช่น EXAMPLESSDK) — ไม่ commit token
printenv CLOUDFLARE_API_TOKEN | npx wrangler d1 migrations apply nvx-db --remote
npm run db:migrations:list   # ต้องเห็น 0024 ✅
สถานะ หมายเหตุ
⏳ รอ owner Cloud agent VM ได้ API 7403 (account ไม่ authorized) — ต้องรันจากเครื่อง owner

Phase 3 — Deploy Worker (ต้องอนุมัติ deploy)#

ตาม deploy-cloudflare.md:

bash
npm run lint && npm run typecheck && npm test && npm run docs:check && npm run cf:build
npm run deploy   # หรือ pipeline ที่ owner ใช้

บันทึก version id หลัง deploy ใน CHANGELOG / บันทึก ops

Phase 4 — Pilot ภายใน (ยังไม่ประกาศสาธารณะ)#

  1. ยังคง CUSTOM_DOMAINS_ENABLED=false บน prod จนกว่าจะทดสอบครบ
  2. ตัวเลือก A — preview workers.dev: deploy ด้วย vars override ใน preview (ถ้ามี pipeline)
  3. ตัวเลือก B — prod flag เฉพาะ admin: ตั้ง CUSTOM_DOMAINS_ENABLED=true ใน wrangler.jsonc แล้ว deploy อีกครั้งเมื่อพร้อม pilot 100–200 คน
  4. Smoke:
    • GET https://devstack.bid/api/hosting/capabilities → customDomains: true (หลังเปิด flag)
    • Admin: GET https://devstack.bid/api/admin/hosting-capacity → headroom.domains = 200
    • โปรเจกต์ที่ production deploy แล้ว: เพิ่มโดเมน → TXT → verify (โซนบน CF account เดียวกับ SITES_CF_*)

Phase 5 — SSR bindings (หลังโดเมนนิ่ง)#

  1. SERVER_BINDINGS_ENABLED=true + deploy
  2. เปิด AI binding บนโปรเจกต์ OpenNext → production deploy ครั้งถัดไป
  3. ตรวจ Workers AI usage / cost บน dashboard

Phase 6 — เปิดสาธารณะ#

  1. อัปเดต FAQ (home.faq2.a3) จาก “internal pilot” เป็นคำอธิบายที่เปิดใช้จริง
  2. ประกาดช่องทางที่ owner เลือก
  3. เปิดรับจนถึงเพดาน DEVSTACK_CUSTOM_DOMAINS_MAX_ACTIVE / MAX_USERS

Checklist หลัง pilot#

สัญญาณ ที่ดู
โควต้า /api/admin/hosting-capacity
Audit audit_events (domain.*)
CF API errors verify → cf_api
Rollback plan wrangler rollback <version> ไม่ถอด custom domains ของผู้ใช้

ค่าใช้จ่าย#

ไม่มี SKU แยกในแอปรอบนี้ — ค่า Workers Custom Domain + SSL บนบัญชีแพลตฟอร์ม; owner อนุมัติ spend ก่อน Phase 4

Source: docs/operations/CUSTOM-DOMAINS-ROLLOUT.md · /docs/operations/custom-domains-rollout.md