DOCUMENTATION / v1.0.0

อัปเกรดจาก 0.8.x เป็น 1.0.0

สำรองข้อมูล รองานบน host ตรวจ signed update และตรวจบริการหลังอัปเกรด

ก่อนอัปเดต

  • ตรวจว่าเผยแพร่ 1.0.0 และ signed update feed แล้วก่อนคาดว่า updater จะติดตั้งรุ่นนี้ การเผยแพร่เว็บไซต์อย่างเดียวไม่ใช่การ release Portal
  • ให้งาน deploy ติดตั้ง tools, Mail และงาน host เบื้องหลังจบก่อน รุ่นเก่ายังไม่เข้าร่วม maintenance lease แบบใหม่ การอัปเกรดครั้งแรกจึงต้องยืนยันว่า host ว่าง
  • สำรอง state แบบ consistent คู่กับ /etc/dashboard-portal/dashboard-portal.env และ HOSTMGR_SECRET_KEY เดิม อย่าคัดลอกเฉพาะ live SQLite file ขณะยังมี writers
  • สำรอง application data, databases, volumes, service configuration และ certificates แยก พร้อมจด Node major ของ Portal กับ active revision ของโปรเจกต์

ติดตั้ง release ที่ตรวจลายเซ็น

รันผ่าน SSH บน Ubuntu host ตรวจเวอร์ชันที่เสนอให้ก่อน Updater ตรวจ Ed25519 ของ manifest และ SHA-256 ของ archive พร้อมคง Node major ที่เลือกไว้ หาก verification ไม่ผ่านให้หยุด ไม่ปิดการตรวจลายเซ็น

sudo dashboard-portal update --check
sudo dashboard-portal update
sudo dashboard-portal update --check

Maintenance และ recovery

ใน 1.0.0 งาน host ที่เข้าร่วมใช้ shared maintenance leases ส่วน installation ใช้ exclusive lock ก่อนหยุดบริการ Lease ที่ยุ่งหรือไม่ปลอดภัยจะปฏิเสธงาน ให้รองานจบแล้ว retry อย่าลบ truncate หรือแทนที่ lock file เพื่อบังคับ update HTTP 503 รวมถึงการบันทึกใช้ Monitor token อาจเกิดระหว่าง maintenance Installer เก็บ managed files กับ state แบบ consistent และพยายาม recovery เมื่อเปลี่ยนไม่สำเร็จ รวม service state ของ Portal/helper แต่ไม่ย้อน packages หรือ certificates ที่ออกไปแล้ว หากรายงาน recovery failure ให้ตรวจผ่าน SSH

หลังอัปเดต

sudo systemctl is-active dashboard-portal hostmgr-deploy-helper nginx
sudo nginx -t
curl -fsS http://127.0.0.1:3100/api/health
curl -fsS https://portal.example.com/api/health
curl -fsSI https://portal.example.com/
  • เข้าสู่ระบบ ตรวจ Settings บัญชี อัปเดต Monitor รวมองค์กร grants และการอ่าน config ที่เข้ารหัส
  • ตรวจ active revision กับ runtime logs ของ Web เดิม โดย records โปรเจกต์เก่าถือเป็น Web
  • ใช้โปรเจกต์ทดสอบตรวจ Web ไม่มีโดเมนและ Worker deploy/rollback การตรวจ process ไม่ยืนยันงาน queue สำเร็จ
  • เก็บ backup state/key เดิมไว้ การ rollback code ไม่ restore ฐานข้อมูลแอปหรือย้อนผลกระทบภายนอก วางแผนตรวจ host restore/reboot แยก
ตรวจทานล่าสุด: 2026-10-15
Source ที่เผยแพร่ · v1.0.0