Nâng cấp ứng dụng NocoBase
Hướng dẫn này áp dụng cho ứng dụng được cài đặt bằng nb init. Nếu ứng dụng của bạn được cài đặt theo cách cũ, hãy đọc trước Cách nâng cấp NocoBase từ 2.0 lên 2.1.
Bước 1: xác nhận env hiện tại
Trước tiên xác nhận CLI env đang có hiệu lực:
Nếu chưa chắc có những env nào, xem danh sách trước:
Nếu env hiện tại không phải ứng dụng cần nâng cấp, chuyển sang env mục tiêu:
Bước 2: chạy nâng cấp
Mặc định, quá trình nâng cấp sẽ tải lại source code ứng dụng hoặc Docker image.
Với env npm / Git, thư mục source/ sẽ bị xóa rồi tải lại. Không đặt các tệp cần giữ lại trong source/.
Nếu bạn đã chuẩn bị source code hoặc Docker image thủ công và không muốn CLI tải lại, hãy thêm --skip-download vào lệnh.
Lệnh nâng cấp mặc định là:
Lệnh này thường thực hiện các bước sau:
- Dừng ứng dụng hiện tại
- Tải và thay thế source hoặc image đã lưu
- Đồng bộ plugin thương mại
- Nâng cấp và khởi động ứng dụng
- Làm mới thông tin runtime của env
Trong script, CI hoặc phiên AI Agent, hãy truyền rõ --force:
Nếu ứng dụng cần nâng cấp không phải env hiện tại, chỉ định env:
Nâng cấp tới phiên bản cụ thể
Dùng --version để nâng cấp tới một kênh phiên bản cụ thể:
Bạn cũng có thể chỉ định số phiên bản chính xác:
Sau khi nâng cấp thành công, CLI ghi phiên bản đích trở lại cấu hình env, để các lần nâng cấp hoặc khôi phục sau có thể tiếp tục dùng thông tin này.
Bỏ qua tải xuống
Nếu bạn đã cập nhật source code hoặc Docker image và chỉ muốn chạy nâng cấp, khởi động dựa trên nội dung hiện tại, thêm --skip-download:
Tham số này bỏ qua việc tải source hoặc image, đồng thời bỏ qua đồng bộ plugin thương mại. Thông thường chỉ dùng khi phiên bản đích đã được chuẩn bị thủ công.
Bước 3: kiểm tra kết quả
Sau khi nâng cấp, trước tiên kiểm tra runtime env và log ứng dụng:
Sau đó mở ứng dụng và xác nhận tài khoản quản trị có thể đăng nhập. Nếu bạn muốn AI Agent tiếp tục thao tác ứng dụng này, hãy mở phiên AI Agent mới hoặc khởi động lại phiên hiện tại để nó đọc thông tin env mới nhất.
Liên kết liên quan
- Quản lý ứng dụng — Khởi động, dừng, restart, xem log và nâng cấp ứng dụng
- Tham chiếu lệnh
nb app upgrade— Xem toàn bộ tham số của lệnh nâng cấp - Quản lý nhiều môi trường — Xác nhận, chuyển đổi và duy trì nhiều CLI env