Skip to main content
Back to articles

Wrangler 4.162.0 เปลี่ยน Artifacts binding ให้จำลองในเครื่องและย้ายค่า Workflows ไปที่ export

Cloudflare Wrangler 4.162.0 เปลี่ยนค่า default ของ Artifacts เป็น local simulator และย้ายค่าควบคุม Workflow exports

Wrangler 4.162.0 เปลี่ยน Artifacts binding ให้จำลองในเครื่องและย้ายค่า Workflows ไปที่ export

Wrangler 4.162.0 เปลี่ยน Artifacts binding ให้จำลองในเครื่องและย้ายค่าควบคุม Workflows ไปที่ export

Cloudflare เผยแพร่ Wrangler 4.162.0 เมื่อ 13 พฤศจิกายน 2026 เวลา 17:11:41 UTC รุ่นนี้มีการเปลี่ยนพฤติกรรมที่ทีมพัฒนา Workers ควรตรวจทันที โดยเฉพาะโปรเจ็กต์ที่ใช้ Artifacts และ Workflows: Artifacts binding ที่ไม่ได้ระบุ remote จะชี้ไปยังตัวจำลองในเครื่องระหว่างพัฒนา ส่วนการกำหนดค่าบางรายการของ Workflow ที่ประกาศผ่าน exports ต้องย้ายจาก binding ไปอยู่บน export เอง ข่าวนี้เป็น release ของเครื่องมือ Wrangler ไม่ใช่ประกาศว่า Artifacts พ้นสถานะ beta หรือ Workflows เปลี่ยนรูปแบบการคิดค่าบริการ

Artifacts ที่ไม่ระบุ remote จะใช้ local simulator

ก่อนรุ่นนี้ หากละ remote ใน Artifacts binding การรันผ่าน Wrangler หรือ Vite plugin อาจไปใช้ Artifacts resource ที่ deploy ไว้จริง รุ่น 4.162.0 กลับค่าเริ่มต้นให้เป็น local simulator เช่นเดียวกับแนวทางของ KV, R2 และ D1 ระหว่างพัฒนา ผลเชิงปฏิบัติคือสคริปต์ที่เคยทดสอบกับข้อมูลใน repository บน Cloudflare โดยไม่ได้เขียนค่า remote ชัดเจนจะเห็นข้อมูลในตัวจำลองแทน การทดสอบที่เคยผ่านเพราะอาศัยข้อมูลจริงจึงอาจล้ม หรือแย่กว่านั้นคือผ่านกับชุดข้อมูลคนละชุด

ทีมที่ต้องใช้ repository ที่ deploy แล้วใน wrangler dev หรือ vite dev ต้องตั้ง remote: true บน binding; หากใช้ cloudflare.config.ts ให้ตั้ง dev: { remote: true } ตามรูปแบบของไฟล์นั้น ส่วนทีมที่ตั้งใจทดสอบในเครื่องควรระบุ remote: false ให้ชัด เพื่อให้ผู้ร่วมทีมอ่านความตั้งใจได้และปิดคำเตือน การเปลี่ยนนี้มีผลกับ getPlatformProxy() ด้วย จึงควรทวน integration tests ที่สร้าง binding ผ่าน proxy ไม่ใช่ดูเฉพาะการรัน wrangler dev

เมื่อ remote ถูกละไว้ Wrangler, Vite plugin และ getPlatformProxy() จะแสดงคำเตือนหากเปิด remote bindings อยู่ โดยจำกัดหนึ่งครั้งต่อ binding แทนการเตือนซ้ำทุกครั้งที่โหลด config ใหม่ ขณะที่ Workers Vitest และ wrangler dev --local ใช้ simulator อยู่แล้วและไม่เตือน การใช้ local Artifacts ไม่ต้องมี Cloudflare credentials แต่เครื่องพัฒนาต้องมี Git อย่างน้อย 2.32 ดังนั้น image CI และเครื่องใหม่ที่เคยมีแต่ Node.js อาจต้องติดตั้ง Git ให้ตรงเงื่อนไขก่อนรันทดสอบ

วิธีตรวจที่ปลอดภัยคือบันทึกพฤติกรรมของ binding ปัจจุบันก่อนอัปเดต จากนั้นทดสอบเส้นทางอ่านและเขียนกับข้อมูลตัวอย่างใน local และ remote แยกกัน อย่าใช้ข้อมูล production ในการลองเขียนเพียงเพื่อยืนยันว่า remote: true ทำงาน และควรดูว่าการ reset simulator จะทำให้ fixture ที่ทีมคาดว่าคงอยู่หายไปหรือไม่

Workflows ที่ประกาศใน exports ต้องกำหนดค่าที่ export

Wrangler รุ่นนี้ยังตรวจ config เข้มขึ้นเมื่อ workflows binding อ้างถึง Workflow ที่ Worker ประกาศใน exports อยู่แล้ว Binding ยังอ้างถึง export ได้ แต่ห้ามใส่ limits, concurrency, schedules, default_retention หรือ jurisdiction บน binding อีกต่อไป ค่ากลุ่มนี้ต้องอยู่บน export ก่อนหน้านี้ binding และ export ใส่ค่าซ้ำกันได้หากตรงกัน แต่หลังอัปเดต config ลักษณะนั้นจะถูกปฏิเสธพร้อมข้อความบอกค่าที่ต้องย้าย

ผู้ดูแลควรค้น config ทุก environment โดยเฉพาะไฟล์ที่ generate จาก template หรือมีการ merge ค่าระหว่าง staging กับ production หากพบค่ากลุ่มดังกล่าวบน binding ให้ย้ายไปยัง export และทดสอบผลต่างของ config ก่อน deploy การแก้ตำแหน่งค่าไม่ควรเปลี่ยนตัวเลขเพดานหรือ schedule ไปพร้อมกัน เพราะจะทำให้แยกสาเหตุของปัญหาหลังปล่อยรุ่นยากขึ้น

ในฝั่ง deploy คำสั่ง wrangler deploy และ wrangler versions upload จะส่งค่าของ Workflow export ได้แก่ limits, concurrency, schedules, default retention และ jurisdiction ไปพร้อม Worker แทนการส่งเพียงชนิดกับชื่อ export การอัปโหลด Worker ที่มี Workflow exports ยังส่ง header Cloudflare-Workers-Script-Api-Date เพื่อให้ Workers API provision export จากค่าดังกล่าวได้ ส่วน wrangler deploy และ wrangler triggers deploy ยังคงสร้างหรืออัปเดต Workflow ผ่าน Workflows API ภายหลังเช่นเดิม

ถ้าการ provision scheduled Workflow ล้มเพราะบัญชีอยู่บนแผนฟรี Wrangler จะอธิบายว่าต้องใช้ Workers plan แบบชำระเงิน ทีมที่มี staging บนแผนฟรีและ production บนแผนเสียเงินจึงควรทดสอบขั้น deploy แยกกัน และอย่าสรุปว่าความล้มเหลวนี้เกิดจาก syntax ของ Workflow เพียงอย่างเดียว

จุดอื่นที่ควรใส่ใน regression test

release notes ระบุการแก้ข้อมูล dependency metadata ของแพ็กเกจที่มี package.json ซ้อนอยู่ เช่น hono, stripe และ @modelcontextprotocol/sdk ซึ่งเคยไม่ปรากฏในข้อมูลที่รายงานตอน wrangler deploy หรือ wrangler versions upload รุ่นใหม่จะรายงานแพ็กเกจเหล่านี้พร้อมเวอร์ชันที่ติดตั้ง และ autoconfig กับ codemod จะตรวจพบเวอร์ชันได้ถูกต้อง ทีมที่นำ deploy metadata ไปทำ inventory หรือ audit ควรคาดว่าจะเห็นรายการเพิ่มขึ้น แม้ไม่ได้เพิ่ม dependency ใหม่ในโปรเจ็กต์

อีกแพตช์แก้อาการ request ค้างหลัง local Worker reload ในจังหวะที่ request เดิมล้มก่อน Worker ตัวใหม่พร้อม โดย Wrangler จะจัดการ request ที่ retry ได้ทันทีเมื่อ Worker ตัวแทนพร้อมแล้ว ปัญหาเดิมพบได้เด่นบน Windows เพราะการรายงาน connection failure อาจช้า ผู้ที่ทำ hot reload ระหว่างทดสอบ API ควรลองเส้นทางนี้ด้วย request ที่ล้มและ retry ได้ ไม่ใช่ตรวจเพียงว่าไฟล์ reload สำเร็จ

สำหรับการอัปเดต ควร pin Wrangler 4.162.0 ในสาขาทดสอบ ตรวจ Artifacts binding ทั้งที่ตั้งและไม่ตั้ง remote, ย้ายค่า Workflow จาก binding ไป export, แล้วทดสอบ dev, getPlatformProxy(), Vite, upload และ deploy ตามที่ทีมใช้จริง หากทุกอย่างผ่านจึงอัปเดต lockfile ของทีมและ runner ใน CI พร้อมกัน ประเด็นสำคัญที่สุดคือค่า default ที่เปลี่ยนจะเปลี่ยนแหล่งข้อมูลของสภาพแวดล้อมพัฒนาโดยไม่ต้องแก้โค้ดแอป ดังนั้นผลทดสอบก่อนและหลังอัปเดตต้องอ้างอิง backend เดียวกัน

แหล่งข่าวต้นทาง: Cloudflare Workers SDK — Wrangler 4.162.0 release notes (ประกาศ 13 พฤศจิกายน 2026 เวลา 17:11:41 UTC)