สารบัญคู่มือ

อัปเดตสาน

ใช้กับสานรุ่น 0.8.0 · ตรวจทานล่าสุด

แพ็กเกจอัปเดตทุกไฟล์มีลายเซ็นของโครงการ ระบบปฏิเสธแพ็กเกจที่ถูกแก้ ลายเซ็นไม่ตรง รุ่นเก่ากว่าที่ติดตั้ง หรือพยายามเขียนนอกพื้นที่ของตัวเอง (เช่น .env หรือ storage) แพ็กเกจแกนชื่อ saan-core-<รุ่น>.zip แพ็กเกจโมดูลชื่อ saan-mod-<id>-<รุ่น>.zip รุ่นและค่า SHA-256 ประกาศที่หน้าดาวน์โหลด

สำรองข้อมูลก่อนอัปเดตเสมอ และควรลองบนเครื่องทดสอบก่อน โดยเฉพาะการอัปเดตรุ่นใหญ่ (major) ที่ต้องอ่านบันทึกการเปลี่ยนแปลงก่อน

ชนิดของรุ่น

  • patch (เช่น 0.6.1 เป็น 0.6.2) แก้บั๊กหรือความปลอดภัย ไม่เปลี่ยนโครงฐานข้อมูลแบบลบ
  • minor เพิ่มความสามารถ และเพิ่มตารางหรือคอลัมน์เท่านั้น
  • major เปลี่ยนแบบที่ต้องอ่านบันทึกการเปลี่ยนแปลงก่อนอัปเดต

อัปเดตจากหลังบ้าน

ตั้งแต่รุ่น 0.8.0 ผู้ดูแลระบบมีหน้า "อัปเดตระบบ" (/admin/updates) ที่เมนูด้านซ้าย หน้านี้แสดงรุ่นที่ติดตั้งของสาน Laravel PHP และฐานข้อมูล

ให้ระบบดาวน์โหลดเอง (ต้องเลือกโหมด "แจ้งเตือนรุ่นใหม่" หรือ "อัปเดตแพตช์อัตโนมัติ" ในส่วน "การตั้งค่า" ก่อน ค่าเริ่มต้นคือปิด ระบบไม่เชื่อมต่อภายนอกเลย)

  1. กด "ตรวจรุ่นใหม่" ระบบอ่านประกาศรุ่นที่ลงลายเซ็นของโครงการ แล้วแสดงรุ่นใหม่ของแกนระบบและโมดูล
  2. กด "ดาวน์โหลดและติดตั้ง" กรอกรหัสผ่านของผู้ดูแลแล้วยืนยัน ระบบดาวน์โหลดแพ็กเกจ ตรวจขนาด ค่า SHA-256 และลายเซ็น สำรองข้อมูล แล้วติดตั้ง ระหว่างนี้เว็บไซต์ปิดชั่วคราว
  3. รอจนส่วน "การทำงาน" ขึ้นว่าเสร็จ ผลอยู่ในส่วน "ประวัติ"

ติดตั้งจากไฟล์ที่อัปโหลดเอง (ใช้ได้ทุกโหมด รวมถึงโหมดปิด)

  1. อัปโหลด saan-core-*.zip หรือ saan-mod-*.zip ผ่าน File Manager ไปที่ storage/app/private/updates/incoming/
  2. เปิดหน้า "อัปเดตระบบ" ส่วน "ติดตั้งจากไฟล์ที่อัปโหลดเอง" แสดงแพ็กเกจที่พบ
  3. กรอกรหัสผ่านของผู้ดูแลแล้วกดติดตั้ง รอจนขึ้นบันทึกผล

โหมด "อัปเดตแพตช์อัตโนมัติ" ติดตั้งเฉพาะรุ่นแก้ไข (patch) ในช่วงเวลากลางคืนที่กำหนด และต้องมี cron ของระบบทำงานอยู่ รุ่นที่เพิ่มความสามารถหรือรุ่นใหญ่ผู้ดูแลต้องกดติดตั้งเอง

ติดตั้งแบบมาตรฐาน (สองโฟลเดอร์แอป) ระบบสั่ง saan:update --both ผ่าน PHP CLI ให้เองเมื่อโฮสต์อนุญาต ถ้าไม่ได้ ระบบบอกวิธีใช้ SSH หรือ cron ชั่วคราว

อัปเดตด้วยคำสั่ง

php artisan saan:update /path/saan-core-<รุ่น>.zip --check
php artisan saan:update /path/saan-core-<รุ่น>.zip

--check ตรวจลายเซ็น ไฟล์ และข้อกำหนดเท่านั้น ไม่แก้อะไร แสดง [OK] ลายเซ็นและไฟล์ถูกต้อง ตามด้วยชนิดแพ็กเกจ รหัส รุ่นเดิมและรุ่นใหม่ ถ้ามีข้อควรแก้จะแสดงเป็น [WARN] และคำสั่งจบด้วยรหัสที่ไม่ใช่ 0

ตัวอัปเดตทำตามลำดับนี้ ตรวจลายเซ็นและ SHA-256 ของทุกไฟล์ ตรวจ PHP พื้นที่ว่าง สิทธิ์เขียน และโมดูลที่ต้องใช้ สำรองฐานข้อมูลและไฟล์ด้วย school:archive พักไฟล์ใหม่ไว้ในโฟลเดอร์อัปเดตขณะที่เว็บยังเปิดอยู่ ปิดเว็บ สลับไฟล์ ให้ PHP ที่เริ่มใหม่บนโค้ดรุ่นใหม่ทำ migrate (เพิ่มอย่างเดียว) ล้าง cache ตรวจสุขภาพ แล้วเปิดเว็บ ความล้มเหลวก่อนสลับไฟล์ไม่แตะเว็บเลย

ตัวเลือกใช้ทำอะไร
--checkตรวจลายเซ็น ไฟล์ และข้อกำหนดเท่านั้น
--bothติดตั้งแบบมาตรฐาน อัปเดตระบบภายในก่อนแล้วจึงหน้าบ้าน (path ของหน้าบ้านอ่านจาก storage/installed.json) ถ้าฝั่งใดล้มจะคืนทั้งสองฝั่ง
--php=<path>ระบุ PHP CLI สำหรับหน้าบ้านเมื่อใช้ --both ค่าเริ่มต้นคือ PHP ที่รันคำสั่งนี้
--all=<โฟลเดอร์>ติดตั้งทุกแพ็กเกจของรุ่นในโฟลเดอร์เดียว (ดูด้านล่าง)
--recoverคืนสถานะของการอัปเดตที่ค้าง (ดูด้านล่าง)
--skip-db-backupไม่สำรองฐานข้อมูลก่อน ไม่แนะนำ

คำสั่งปฏิเสธตั้งแต่ต้นถ้าผู้ใช้ระบบที่รันคำสั่งไม่ใช่เจ้าของไฟล์ของแอป (เช่น รันด้วย root)

ติดตั้งทั้งรุ่นด้วย --all

php artisan saan:update --all=/path/ของ/โฟลเดอร์รุ่น

ติดตั้งแกนระบบก่อน แล้วตามด้วยแพ็กเกจโมดูลทุกตัวในโฟลเดอร์ตามลำดับที่โมดูลต้องการกัน

  • คำสั่งตรวจลายเซ็นและ SHA-256 ของทุกแพ็กเกจก่อนติดตั้งตัวแรก
  • แพ็กเกจที่เก่ากว่ารุ่นที่ติดตั้งอยู่ถูกข้าม และแสดง [WARN] ข้าม ...
  • แต่ละแพ็กเกจทำใน process ของตัวเอง และสำรองฐานข้อมูลครั้งเดียวที่แพ็กเกจแรก
  • ล้มที่แพ็กเกจใด คำสั่งหยุดที่แพ็กเกจนั้น แพ็กเกจนั้นคืนรุ่นเดิมให้แล้ว ส่วนที่ติดตั้งไปก่อนหน้าคงอยู่ แก้สาเหตุแล้วสั่งคำสั่งเดิมซ้ำได้
  • ใช้ร่วมกับ --both ได้
  • ต้องเริ่ม PHP CLI ได้ (proc_open เปิดอยู่และพบ php) ถ้าไม่ได้ ให้ติดตั้งทีละแพ็กเกจตามลำดับที่คำสั่งแสดง หรือกำหนด SAAN_PHP_CLI

ระหว่างอัปเดต ผู้เข้าชมเห็นอะไร

ระบบตรวจและพักไฟล์ใหม่ขณะที่เว็บยังเปิดอยู่ แล้วจึงปิดเว็บเพื่อสลับไฟล์ ช่วงที่ปิด ผู้เข้าชมเห็นหน้า "กำลังปรับปรุงระบบ" (รหัส 503) ที่โหลดใหม่เอง ข้อมูลไม่สูญหาย ในการทดสอบของโครงการช่วงนี้นานตั้งแต่ราวหนึ่งวินาทีถึงราวหนึ่งนาที ขึ้นกับจำนวนไฟล์ที่เปลี่ยน เมื่อทุกขั้นผ่าน เว็บเปิดเป็นรุ่นใหม่

ถ้าอัปเดตไม่สำเร็จ

หากขั้นใดไม่สำเร็จ ระบบคืนไฟล์รุ่นเดิมจากสำเนาที่เก็บไว้และเปิดเว็บให้เอง ประวัติทุกครั้งดูได้ในหน้าตรวจความพร้อม ระบบเก็บสำเนาไฟล์ของการอัปเดต 2 ครั้งล่าสุด ที่เก่ากว่านั้นเหลือเฉพาะบันทึก

ถ้าตัวที่เริ่มอัปเดตถูกตัดกลางคัน (หมดเวลาหรือถูกปิด) และหน้า "กำลังปรับปรุงระบบ" ค้างนานผิดปกติ

  • cron schedule:run ที่ตั้งไว้สั่ง saan:update --recover --auto ทุกนาที และปิดงานที่ค้างให้เอง ถ้าทุกขั้นผ่านแล้วเว็บเปิดเป็นรุ่นใหม่ ถ้าไม่ครบจะคืนรุ่นเดิม โฮสต์ที่ไม่มี SSH จึงต้องมี cron
  • ถ้ามี SSH สั่งเองได้ด้วย php artisan saan:update --recover ใช้ได้ทั้งสองกรณีโดยไม่เสียข้อมูล
  • --recover-dir=<โฟลเดอร์> ระบุโฟลเดอร์อัปเดตใต้ storage/app/private/updates ที่ต้องการคืน แทนโฟลเดอร์ล่าสุดที่ยังไม่เสร็จ

ดูเพิ่มที่แก้ปัญหาที่พบบ่อย

ตรวจรุ่นใหม่

ตัวตรวจรุ่นใหม่เลือกเปิดได้ที่หน้า "อัปเดตระบบ" (/admin/updates) ส่วน "การตั้งค่า" ปิดอยู่เป็นค่าเริ่มต้น ใช้ประกาศรุ่นที่ลงลายเซ็นของโครงการ ไม่มีการเก็บข้อมูลการใช้งาน (telemetry) โหมด "แจ้งเตือนรุ่นใหม่" ไม่ติดตั้งอะไรเอง มีเฉพาะโหมด "อัปเดตแพตช์อัตโนมัติ" ที่ติดตั้งเอง และติดตั้งเฉพาะรุ่นแก้ไข คำสั่ง php artisan saan:self-update ทำงานเดียวกันจากบรรทัดคำสั่ง

หลังอัปเดต

รัน php artisan school:doctor หรือเปิด /cms#deployment เพื่อตรวจ ดูตรวจความพร้อมของระบบ รายละเอียดอื่นอยู่ในคู่มือข้ออัปเดตระบบและโมดูล

พบข้อผิดพลาดหรืออยากให้เพิ่มเนื้อหา แจ้งได้ที่ แบบฟอร์มติดต่อ