メインコンテンツへスキップ
記事一覧へ戻る

Supabase CLI 3.2.0-beta.16 เพิ่ม config validate ตรวจไฟล์ตั้งค่าครบก่อนรันบริการ

Supabase CLI beta.16 เพิ่ม config validate ตรวจ TOML/JSON, remotes และ env() แบบ deterministic พร้อม JSON report และ exit code สำหรับ CI

Supabase CLI 3.2.0-beta.16 เพิ่ม config validate ตรวจไฟล์ตั้งค่าครบก่อนรันบริการ

Supabase CLI 3.2.0-beta.16 เพิ่ม config validate ตรวจไฟล์ตั้งค่าครบก่อนรันบริการ

Supabase เผยแพร่ CLI 3.2.0-beta.16 เมื่อ 13 พฤศจิกายน 2026 เวลา 20:27:04 UTC โดยฟีเจอร์ใหม่คือ supabase config validate สำหรับตรวจไฟล์ config ของโครงการโดยไม่ต้องเริ่ม local stack หรือเรียกคำสั่งอื่นก่อน จุดที่แก้ปัญหาได้จริงคือเดิมข้อผิดพลาดใน config มักโผล่ทีละรายการเมื่อคำสั่งอื่นโหลดไฟล์ ทำให้ทีมต้องแก้แล้วรันใหม่หลายรอบ โดยเฉพาะใน CI ที่ต้องเสียเวลาสร้าง environment เพื่อพบว่าคีย์ผิดชนิดหรือไฟล์กำกวม

ตรวจทั้ง syntax, schema และความสัมพันธ์ระหว่างคีย์

คำสั่งใหม่รองรับ config.toml, config.json และ config.jsonc ตามไฟล์ที่เลือก มันรายงาน syntax error, เวอร์ชัน schema, คีย์ที่ถูกถอดออก, คีย์ที่ไม่รู้จักพร้อมคำแนะนำชื่อใกล้เคียง, ชนิดข้อมูล, enum, ค่า, กฎระดับตาราง และการตรวจข้ามคีย์แบบเดียวกับที่ start ใช้ แทนการหยุดที่ error ตัวแรก validator พยายามรวบรวมปัญหาที่ตัดสินได้ทั้งหมดในรอบเดียว พร้อมตำแหน่งไฟล์ บรรทัด และคอลัมน์จากข้อความต้นทาง

หากโครงการมีทั้ง config.toml และ config.json validator จะถือเป็น error เพราะไม่ชัดว่าทีมต้องการให้ใช้ไฟล์ไหน ขณะที่คำสั่งอื่นยังแค่เตือนและเลือกไฟล์หนึ่งตามพฤติกรรมเดิม นี่เป็นการตั้งมาตรฐานที่เข้มขึ้นเฉพาะการตรวจล่วงหน้า ไม่ได้แปลว่าการอัปเดต beta นี้เปลี่ยนพฤติกรรมของ start ทุกกรณี ผู้ดูแล repository ควรลบไฟล์ที่ไม่ใช้หรือกำหนดรูปแบบหลักให้ชัดก่อนเพิ่ม validator เข้า CI

อีกจุดคือ validator ตรวจทุกบล็อก [remotes.*] โดยนำ config ฐานไปรวมกับ remote แต่ละตัว แล้วติดป้ายผลตาม remote ที่เกี่ยวข้อง ทีมที่มี environment สำหรับ staging และ production จะเห็นว่าปัญหาเกิดเฉพาะ remote ไหน ไม่ต้องสลับ environment และรันหลายรอบเพียงเพื่อไล่หาคีย์ที่ผิด การตรวจนี้เหมาะกับ pull request ที่แก้ไฟล์ config เพราะ reviewer จะเห็นปัญหาของทุกเป้าหมายก่อน merge

env() ปริยายไม่ถูกแทนค่า เพื่อให้ CI ได้ผลเหมือนกัน

หาก config ใช้ env() คำสั่งจะถือค่าเหล่านั้นเป็น unknown โดยปริยาย และข้ามการตรวจที่ต้องอ่านค่าดังกล่าว พร้อมบอกจำนวนตัวแปรและจำนวน check ที่ข้าม วิธีนี้ทำให้ผลตรวจจากไฟล์ที่ commit เหมือนกันทุกเครื่องโดยไม่ขึ้นกับ secret ใน shell ของนักพัฒนา เมื่อจำเป็นต้องตรวจค่าจริง ให้ใช้ --resolve-env ซึ่งค้นจาก shell และไฟล์ .env* ตาม SUPABASE_ENV เหมือน loader ปกติ ค่าที่พบจะถูกตรวจเหมือน literal ส่วนค่าที่ไม่ตั้งหรือว่างอาจเป็น error หรือ warning ตามชนิดคีย์และความจำเป็นของ check

ผลแบบข้อความไม่พิมพ์ source text หรือค่าที่ตั้ง เพื่อเลี่ยงการเผยข้อมูลลับใน CI log โหมด --output-format json ให้ payload ที่มีเวอร์ชัน, รหัสปัญหา, path ของคีย์, ตำแหน่ง, รายการ check ที่รอค่า และ flag complete คำสั่งคืน exit code 1 เมื่อพบ error และไม่ติดต่อ Supabase API จึงใช้เป็น gate ที่เร็วและไม่ต้องใช้ credential ของบริการภายนอก แต่ CI ที่ใช้ --resolve-env ยังต้องจัดการ secret ของ runner อย่างรอบคอบ

วิธีนำไปใช้โดยไม่สับสนกับการทดสอบ runtime

ทีมสามารถเพิ่ม supabase config validate หลัง checkout และติดตั้ง CLI ใน pipeline แล้วเก็บ JSON report เป็น artifact สำหรับให้ PR bot แสดงข้อผิดพลาดเฉพาะบรรทัด ก่อนปล่อย production ควรมีรอบที่เปิด --resolve-env ใน environment ที่มีค่าเหมือนจริงเพื่อตรวจข้อจำกัดที่ขึ้นกับค่าจาก env แต่ไม่ควรเผยค่าจริงผ่าน log หรือแนบไฟล์ .env ไปกับ artifact

คำสั่งนี้เป็นการตรวจโครงสร้างและกฎของ config ไม่ได้ยืนยันว่า database, edge function หรือบริการภายนอกจะเริ่มทำงานได้จริง การทดสอบ supabase start, migration และ integration test ยังมีบทบาทต่างกัน ที่สำคัญรุ่นนี้เป็น beta ควร pin เวอร์ชันใน CI และทดลองกับ repository ตัวอย่างก่อนบังคับทุกโครงการ หากมี config ที่ validator ปฏิเสธแต่คำสั่งเดิมยังรันได้ ให้ตรวจว่าเป็นกฎเข้มขึ้นโดยตั้งใจ เช่นการมีไฟล์สองรูปแบบ มากกว่าปิด gate ทันที

แหล่งข่าวต้นทาง: Supabase CLI 3.2.0-beta.16 release (ประกาศ 13 พฤศจิกายน 2026) และ PR เพิ่ม config validate