Lệch phiên bản frontend / backend

Triệu chứng

Trong Cài đặt → Thông tin, dòng Phiên bản Backend hiển thị màu hổ phách, kèm gợi ý rằng phiên bản frontend và backend khác nhau.

Ý nghĩa các dòng

Bảng Thông tin hiển thị ba phiên bản:

• Phiên bản phát hành — bản phát hành mà box đã cài, do trình cài đặt ghi lại từ bundle. Đây là câu trả lời cho “box này đang chạy phiên bản nào”.
• Phiên bản Frontend — phiên bản được biên dịch vào bundle frontend bạn đang xem.
• Phiên bản Backend — phiên bản được biên dịch vào image backend.

Một bản phát hành dùng lại image cũ cho service không thay đổi. Vì vậy, trên một box đã cập nhật đúng, phiên bản build của frontend và backend vẫn có thể khác nhau. Màu hổ phách chỉ so sánh hai phiên bản build này, nên tự nó không có nghĩa là có lỗi.

Xác nhận

Hỏi box đang chạy bản phát hành nào và backend mang build nào:

curl -s http://localhost:5000/api/system/health | jq '{releaseVersion, version, commit}'

• releaseVersion khớp với bundle bạn đã cài → cập nhật đã hoàn tất. Dòng hổ phách chỉ phản ánh một service được giữ nguyên.
• releaseVersion cũ hơn bundle bạn đã cài, hoặc là null → cập nhật chưa xong, hoặc box được cài bằng bản phát hành có từ trước khi có tính năng báo cáo bản phát hành.

Sửa

1. Loại trừ tab trình duyệt cũ. Phiên bản frontend được cố định khi trang tải. Tải lại trang bỏ qua cache rồi xem lại Cài đặt → Thông tin.

2. Nếu dòng Phiên bản phát hành không phải bản bạn đã cài, chạy lại cập nhật từ thư mục bundle của bản đó:

   sudo ./update.sh

   Bản cập nhật khởi động frontend, backend và inference cùng lúc từ các image trong bundle.

3. Kiểm tra. Tải lại Cài đặt → Thông tin. Dòng Phiên bản phát hành phải hiển thị bản bạn đã cài.

Chú ý

Đừng chạy build có phiên bản 0.0.0-dev... hoặc kết thúc bằng -dirty. Loại đầu nghĩa là build đó không có tag phát hành; loại sau nghĩa là nó chứa sửa đổi cục bộ chưa commit. Cả hai đều không tái tạo được. Hãy cài một bản phát hành có phiên bản chính thức.

Phòng ngừa

• Cập nhật bằng bundle phát hành, không cập nhật từng container. update.sh giữ ba service đồng bộ với bản phát hành.
• Xem dòng Phiên bản phát hành sau mỗi lần cập nhật. Đó là bước kiểm tra sau cập nhật; các dòng phiên bản build dành cho hỗ trợ kỹ thuật.

Liên quan

• Phiên bản & Cập nhật — cách phiên bản được báo cáo trên thiết bị.
• Release Notes — những gì đã ship trong mỗi phiên bản.