Skip to content
Rollback

Rollback

View raw
On this page

การ rollback คือการสั่งให้ Cloudflare กลับไปเสิร์ฟ เวอร์ชันก่อนหน้าของ Worker ทันที โดยไม่ต้อง build ใหม่ ใช้เมื่อ deploy แล้วพบปัญหาร้ายแรง (หน้าพัง, API error, ความปลอดภัย) คำสั่งต้นฉบับอยู่ใน DEPLOY.md หัวข้อ 5

หลักการ#

  • Worker ทุกการ deploy (และทุกการตั้ง secret) สร้าง version ใหม่ที่มี id
  • secret และ vars ผูกกับเวอร์ชัน rollback จึงคืนทั้งโค้ดและ binding ของเวอร์ชันนั้น ถ้าเพิ่งหมุน key แล้ว rollback ไปเวอร์ชันก่อนหมุน Worker จะใช้ key เก่า (ซึ่งอาจถูก revoke แล้ว) — ให้ตั้ง secret ใหม่หลัง rollback ถ้าจำเป็น
  • rollback เป็นการกระทำกับ production ต้องได้รับอนุมัติจากมนุษย์ (ยกเว้นมีนโยบายฉุกเฉินที่เจ้าของกำหนดไว้ล่วงหน้า)

เป้าหมาย rollback ที่บันทึกไว้#

Production v0.6.0 (ปัจจุบัน): https://devstack.bid (+ www.devstack.bid), workers.dev สำรอง https://nvx-stack-builder.examplessdk.workers.dev, บัญชี 2d92bd5b25768fa9093d6adc0a8887fc

เวอร์ชัน id หมายเหตุ
ปัจจุบัน 450890b7-5432-4795-afbc-1c7ebd241bff v0.6.0 + D1 binding DB (branch feat/d1-chat-schema, ยังไม่มีโค้ดใช้ D1)
ก่อนหน้า (rollback แรก) 7ddd9404-a31f-4e31-8460-82b3b90c7d0e v0.6.0 (tag v0.6.0): docs ในแอป /docs, raw .md, /llms.txt, signature
ก่อนหน้า 671b6b3b-1074-40cb-84b0-0df2681b69ce v0.5.1: metadata ชี้ devstack.bid, HSTS ไม่มี includeSubDomains, redirect www → apex
ก่อนหน้านั้น d369f2b6-863a-4e44-8f9e-b5551e18361a v0.5.0 + secret (ถ้าย้อนมา: HSTS กลับเป็น includeSubDomains และ OG ชี้ space6 ซึ่งใช้ไม่ได้แล้ว)
เก่ากว่า 107ab78e-2cdd-4159-95e7-e8fcb89130aa v0.5.0 ก่อนตั้ง secret (AI agent จะใช้ offline planner)

rollback เวอร์ชันไม่ถอด custom domain โดเมนยังชี้ Worker เดิม (ดู custom-domain.md)

บัญชีนี้ไม่มีเวอร์ชันเก่ากว่านี้ ถ้าต้องกลับไปใช้ดีไซน์ v0.3.0 ให้ใช้ deploy เดิมที่ยังเปิดอยู่ (ด้านล่าง) หรือ build tag v0.3.0 แล้ว deploy ใหม่ (ต้องได้รับอนุมัติ)

TEST deploy v0.3.0 (เดิม ไม่ถูกแก้ไข): https://nvx-stack-builder.agen-sdk-work.workers.dev, บัญชี f70d35188a3c56b9781538c73a86e04e

เวอร์ชัน id หมายเหตุ
ปัจจุบัน 0fb9ecd4-d788-468c-8843-559545c357e3 รวม IPv6 /64 rate-limit key
ก่อนหน้า 9b9b678a-f0b4-4727-96d7-e5f81fc00391 ก่อนแก้ IPv6

เมื่อ deploy เวอร์ชันใหม่ ให้บันทึก id ใหม่ไว้ใน DEPLOY.md, CHANGELOG และหน้านี้

ขั้นตอน#

bash
export CLOUDFLARE_ACCOUNT_ID=2d92bd5b25768fa9093d6adc0a8887fc   # v0.5.0; ใช้ f70d35188a3c56b9781538c73a86e04e สำหรับ deploy v0.3.0 เดิม
# 1) ดูรายการเวอร์ชัน
npx wrangler deployments list --name nvx-stack-builder
# 2) rollback ไปเวอร์ชันที่ต้องการ พร้อมเหตุผล
npx wrangler rollback <version-id> --name nvx-stack-builder -m "reason: <อธิบาย>"
# 3) smoke test ตาม deploy-cloudflare.md

ทางเลือกสุดท้าย (หยุดเสิร์ฟ Worker ทดสอบทั้งหมด): npx wrangler delete --name nvx-stack-builder — ลบเฉพาะ Worker นี้ ห้ามใช้กับ Worker อื่น และต้องได้รับอนุมัติชัดเจน เพราะย้อนกลับไม่ได้ (ต้อง deploy ใหม่)

Rollback ฝั่งโค้ด (git)#

  • rollback บน Cloudflare ไม่เปลี่ยน git ให้เปิด branch แก้ไข หรือ git revert <commit> บน branch แล้ว deploy ใหม่ตามขั้นตอนปกติ
  • ห้าม git reset --hard หรือ force-push บน branch ที่แชร์ โดยไม่ได้รับอนุมัติ
  • tag ที่ deploy แล้ว (v0.5.0, v0.3.0) ใช้ build ซ้ำได้ เช่น git checkout v0.3.0 && npm ci && npm run deploy

Checklist หลัง rollback#

  • หน้า /, /templates, /builder, /design ได้ 200 และ /templates/x ได้ 404
  • GET /api/plan → serverKeyConfigured ตามที่คาด
  • headers ความปลอดภัยครบ
  • บันทึกเหตุการณ์ (เวลา UTC+7, เวอร์ชันจาก → ไป, สาเหตุ) ใน CHANGELOG หรือ incident note
  • เปิด issue/branch แก้ต้นเหตุก่อน deploy ใหม่

Source: docs/operations/rollback.md · /docs/operations/rollback.md