Phiên bản & Cập nhật
Hai loại phiên bản mô tả một box Xisom. Phiên bản phát hành là gói phát hành bạn đã cài. Phiên bản build là phiên bản được biên dịch vào từng thành phần. Hãy kiểm tra phiên bản phát hành trước tiên sau một lần cập nhật hoặc khi có gì đó hoạt động bất thường.
Bảng About
Phần tiêu đề “Bảng About”Mở Settings → About. Bảng hiển thị:
| Dòng | Ý nghĩa |
|---|---|
| Phiên bản phát hành | Gói phát hành được cài trên box này, ví dụ v1.58.4. Đây là phiên bản của box. |
| Phiên bản Frontend | Phiên bản build của bảng điều khiển đang tải trong trình duyệt. |
| Commit Frontend | Commit mã nguồn của bản build bảng điều khiển đó. |
| Phiên bản Backend | Phiên bản build của backend đang chạy, kèm commit. |
| Ngày build | Thời điểm bảng điều khiển được build. |
| Môi trường | Chế độ build của bảng điều khiển, production trên box đã xuất xưởng. |
Thanh bên và màn hình đăng nhập hiển thị cùng phiên bản phát hành.
Trình cài đặt ghi phiên bản phát hành khi cài đặt hoặc cập nhật box. Nó đọc phiên bản từ gói, không phải từ các image. Nếu box được cài trước khi có tính năng báo cáo phiên bản phát hành, dòng Phiên bản phát hành hiển thị phiên bản build thay thế, và một gợi ý bên cạnh cho biết điều đó. Lần cập nhật tiếp theo sẽ điền giá trị này.
Bạn cũng có thể đọc cả hai phiên bản từ health endpoint:
curl -s http://<box-ip>/api/system/health# → { "version": "...", "commit": "...", "buildTime": "...", "releaseVersion": "v1.58.4", ... }releaseVersion là phiên bản phát hành. version là phiên bản build của backend.
Phiên bản phát hành và phiên bản build
Phần tiêu đề “Phiên bản phát hành và phiên bản build”Một bản phát hành chỉ build lại các thành phần đã thay đổi. Thành phần không thay đổi được đưa nguyên vào bản phát hành mới, và giữ phiên bản build của bản phát hành gần nhất đã thay đổi nó. Vì vậy, sau một lần cập nhật:
- Phiên bản phát hành hiển thị bản phát hành bạn đã cài.
- Phiên bản Frontend và Phiên bản Backend có thể cũ hơn bản phát hành.
- Hai phiên bản này cũng có thể khác nhau.
Điều này không có nghĩa là cập nhật thất bại. Phiên bản phát hành mới là thứ cho biết box đang chạy gì.
Cảnh báo không khớp phiên bản
Phần tiêu đề “Cảnh báo không khớp phiên bản”Khi phiên bản build của frontend và backend khác nhau, dòng Phiên bản Backend được làm nổi bật, kèm gợi ý refresh trang hoặc redeploy.
Về mặt vận hành:
- Tab trình duyệt cũ — tải lại mạnh (hard-refresh) bảng điều khiển (hoặc đóng rồi mở lại).
- Cảnh báo vẫn còn sau khi tải lại — kiểm tra dòng Phiên bản phát hành. Nếu nó hiển thị bản phát hành bạn đã cài, sự khác biệt này là bình thường.
- Dòng Phiên bản phát hành không phải bản bạn đã cài — cập nhật chưa hoàn tất. Hãy chạy lại. Xem Cài đặt từ gói offline → Cập nhật.
Sau khi cập nhật
Phần tiêu đề “Sau khi cập nhật”- Mở lại Settings → About.
- Xác nhận dòng Phiên bản phát hành hiển thị phiên bản bạn đã cài.
- Nếu có cảnh báo không khớp, hãy tải lại mạnh. Nếu bản phát hành sai, hãy chạy lại quá trình cập nhật.
Nếu có gì đó sai sót
Phần tiêu đề “Nếu có gì đó sai sót”- Lệch phiên bản kéo dài sau khi đã tải lại và cập nhật lại — xem runbook Troubleshooting.