Chuyển đến nội dung chính
Quay lại danh sách bài viết

Durable Objects เลื่อนอัปเดตโค้ดเป็นค่าเริ่มต้น ลดการตัดงานระหว่าง Deploy

Cloudflare ให้ Durable Objects ที่ active รอโค้ดใหม่ได้สูงสุด 300 วินาที ลดการขัดจังหวะงานและ WebSocket พร้อมโหมด immediate สำหรับเหตุเร่งด่วน

Durable Objects เลื่อนอัปเดตโค้ดเป็นค่าเริ่มต้น ลดการตัดงานระหว่าง Deploy

Durable Objects เลื่อนอัปเดตโค้ดเป็นค่าเริ่มต้น ลดการตัดงานและ WebSocket ระหว่าง Deploy

Cloudflare ประกาศวันที่ 30 ตุลาคม 2026 ว่า Durable Objects เปลี่ยนพฤติกรรมการอัปเดตโค้ดหลัง deploy ให้เลื่อนการใช้เวอร์ชันใหม่เป็นค่าเริ่มต้น เดิมเมื่อ deploy โค้ดที่เกี่ยวกับ Durable Object การเปลี่ยนจะถูกนำไปใช้ทันทีและอาจขัดจังหวะงานที่กำลังทำหรือปิดการเชื่อมต่อที่เปิดอยู่ ขณะนี้ออบเจ็กต์ที่ยังทำงานสามารถรันโค้ดเวอร์ชันเดิมต่อได้สูงสุด 5 นาทีหรือ 300 วินาที ระหว่างรอเข้าสู่สถานะ hibernation

Durable Object มีเอกลักษณ์หนึ่งเดียวทั่วระบบสำหรับ ID ของมัน จึงต้องรันโค้ดเพียงเวอร์ชันเดียวในแต่ละขณะ หากมีการอัปเดตระหว่างงานที่ใช้เวลานาน เช่น เอเจนต์ที่ทำงานต่อเนื่อง ห้องสนทนา หรือ WebSocket ที่ยังเปิดอยู่ การเปลี่ยนทันทีอาจทำให้ state และการเชื่อมต่อสะดุด แนวทางใหม่ให้เวลางานที่กำลังดำเนินอยู่จบลงก่อน แล้วจึงใช้โค้ดใหม่เมื่อเหมาะสม โดย WebSocket ที่ใช้ Hibernation API สามารถคงการเชื่อมต่อไว้เมื่อออบเจ็กต์รับโค้ดใหม่หลัง hibernate

ลำดับการทำงานตามเอกสารคือ เมื่อ deploy เวอร์ชันใหม่ ออบเจ็กต์ที่ active ยังใช้โค้ดเก่าต่อระหว่างช่วงผ่อนผัน หาก hibernate ก่อนหมดเวลา คำขอถัดไปจะเริ่มบนโค้ดใหม่ แต่หากครบเวลาที่ยอมให้เลื่อนก่อน ออบเจ็กต์จะ reset แล้วรับโค้ดใหม่ ผู้พัฒนาจึงต้องออกแบบให้ระบบทนต่อการ reset อยู่ดี การเลื่อนอัปเดตช่วยลดโอกาสขัดจังหวะ แต่ไม่ใช่คำรับประกันว่าทุก operation จะจบอย่างราบรื่น

Cloudflare ให้ปรับ code_update_strategy ในส่วน durable_objects ของ Wrangler configuration ได้ โดยใช้โหมด deferred และกำหนด max_delay เป็นวินาที ค่าเริ่มต้นคือ 300 วินาที และเอกสารระบุช่วงที่ตั้งได้ตั้งแต่ 0 ถึง 86400 วินาที หรือ 24 ชั่วโมง การเลือกเวลานานขึ้นอาจเหมาะกับงานที่ต้องรอจบ แต่จะทำให้โค้ดเก่าคงอยู่ระหว่าง deployment นานขึ้น ทีมควรกำหนดตามลักษณะงานและความเร็วที่ต้องการแก้บั๊กหรือปิดช่องโหว่

สำหรับเหตุการณ์ที่ต้องใช้โค้ดใหม่ทันที Cloudflare ยังรองรับโหมด immediate ผ่านการตั้งค่าหรือพารามิเตอร์ตอน deploy ตัวอย่างในประกาศใช้ --durable-objects-code-update-mode immediate กับคำสั่ง Wrangler versions deploy กรณีนี้เหมาะเมื่อกำลังแก้ incident หรือ deployment tooling ต้องเรียก Durable Object ทันทีหลังเผยแพร่และต้องมั่นใจว่าได้พฤติกรรมเวอร์ชันใหม่ ไม่ควรพึ่งค่าเริ่มต้นแบบเลื่อนในขั้นตอนที่ต้องการความสดของโค้ดแน่นอน

ทีมที่ดูแล Durable Objects ควรทบทวนขั้นตอน rollout และทดสอบงานสองแบบ แบบแรกคือ deployment ปกติขณะมี WebSocket หรือ operation ยาว เพื่อดูว่าการต่อเนื่องดีขึ้นเพียงใด แบบที่สองคือ deployment เร่งด่วนที่บังคับ immediate เพื่อยืนยันว่าแอปรับ reset และการ reconnect ได้ หากมี protocol ระหว่าง client กับ server ที่เปลี่ยนข้ามเวอร์ชัน ต้องพิจารณาช่วงที่ client ใหม่เจอออบเจ็กต์เก่าด้วย เพราะการเลื่อนอัปเดตทำให้โค้ดสองยุคอยู่ในระบบพร้อมกันได้ชั่วคราวในคนละออบเจ็กต์

Cloudflare ย้ำว่าการเลื่อนเป็น best effort ออบเจ็กต์อาจ reset ก่อนครบ max_delay เช่น เมื่อ runtime มีการอัปเดต ดังนั้นการจัดการ state การทำงานซ้ำ การส่งข้อความซ้ำ และการเชื่อมต่อใหม่ยังสำคัญเหมือนเดิม ข่าวนี้ช่วยให้การ deploy ปกติสุภาพกับงานที่กำลังรันมากขึ้น แต่ทีมพัฒนายังต้องวางสัญญาการเปลี่ยนเวอร์ชันให้รองรับทั้งกรณีเลื่อนและกรณีเปลี่ยนทันที

ที่มา: Cloudflare Changelog — Durable Objects deferred code updates ประกาศวันที่ 30 ตุลาคม 2026

Chia sẻ bài viết:
Xem thêm bài viết