อัปเดตสาน
แพ็กเกจอัปเดตทุกไฟล์มีลายเซ็นของโครงการ ระบบปฏิเสธแพ็กเกจที่ถูกแก้ ลายเซ็นไม่ตรง รุ่นเก่ากว่าที่ติดตั้ง หรือพยายามเขียนนอกพื้นที่ของตัวเอง (เช่น .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 และฐานข้อมูล
ให้ระบบดาวน์โหลดเอง (ต้องเลือกโหมด "แจ้งเตือนรุ่นใหม่" หรือ "อัปเดตแพตช์อัตโนมัติ" ในส่วน "การตั้งค่า" ก่อน ค่าเริ่มต้นคือปิด ระบบไม่เชื่อมต่อภายนอกเลย)
- กด "ตรวจรุ่นใหม่" ระบบอ่านประกาศรุ่นที่ลงลายเซ็นของโครงการ แล้วแสดงรุ่นใหม่ของแกนระบบและโมดูล
- กด "ดาวน์โหลดและติดตั้ง" กรอกรหัสผ่านของผู้ดูแลแล้วยืนยัน ระบบดาวน์โหลดแพ็กเกจ ตรวจขนาด ค่า SHA-256 และลายเซ็น สำรองข้อมูล แล้วติดตั้ง ระหว่างนี้เว็บไซต์ปิดชั่วคราว
- รอจนส่วน "การทำงาน" ขึ้นว่าเสร็จ ผลอยู่ในส่วน "ประวัติ"
ติดตั้งจากไฟล์ที่อัปโหลดเอง (ใช้ได้ทุกโหมด รวมถึงโหมดปิด)
- อัปโหลด
saan-core-*.zipหรือsaan-mod-*.zipผ่าน File Manager ไปที่storage/app/private/updates/incoming/ - เปิดหน้า "อัปเดตระบบ" ส่วน "ติดตั้งจากไฟล์ที่อัปโหลดเอง" แสดงแพ็กเกจที่พบ
- กรอกรหัสผ่านของผู้ดูแลแล้วกดติดตั้ง รอจนขึ้นบันทึกผล
โหมด "อัปเดตแพตช์อัตโนมัติ" ติดตั้งเฉพาะรุ่นแก้ไข (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 เพื่อตรวจ ดูตรวจความพร้อมของระบบ รายละเอียดอื่นอยู่ในคู่มือข้ออัปเดตระบบและโมดูล
พบข้อผิดพลาดหรืออยากให้เพิ่มเนื้อหา แจ้งได้ที่ แบบฟอร์มติดต่อ