Hướng dẫn: Nâng cấp version N8n

Tôi sẽ hướng dẫn bạn cách nâng cấp phiên bản N8n hiện tại lên phiên bản mới nhất một cách an toàn và hiệu quả, điều kiện là bạn phải triển khai N8n bằng Docker hoặc Docker Compose.

Bạn có thể xem chi tiết các phiên bản N8n tại N8n Releases

Ở phạm vi bài viết này, tôi chỉ đảm bảo việc cập nhật các phiên bản Minor, Patch như 1.x.x lên 1.y.z hoặc 2.x.x lên 2.y.z.

Semantic Versioning (x.y.z):

• x (Major/Chính): Phiên bản lớn, có thể có breaking changes (ví dụ: 1.x → 2.0)
• y (Minor/Phụ): Thêm tính năng mới, tương thích ngược (ví dụ: 1.0.0 → 1.1.0)
• z (Patch/Vá): Sửa lỗi, tương thích ngược (ví dụ: 1.1.0 → 1.1.1)

Việc nâng cấp giữa các version chính ( major ) như từ 1.x.x lên 2.y.z có thể yêu cầu các bước bổ sung và kiểm tra tương thích, phần này tôi sẽ lên bài viết khác để hướng dẫn chi tiết.

Bước 1: Sao lưu dữ liệu

Trước khi thực hiện bất kỳ nâng cấp nào, hãy đảm bảo bạn đã sao lưu toàn bộ dữ liệu hiện tại của N8n, bao gồm cơ sở dữ liệu và các tệp cấu hình quan trọng.

Điều này giúp bạn có thể khôi phục lại hệ thống nếu có sự cố xảy ra trong quá trình nâng cấp.

Đây là bài viết hướng dẫn sao lưu và khôi phục N8n

Đối với các bản cập nhật Patch, bạn có thể bỏ qua bước này nếu bạn cảm thấy tự tin về quá trình nâng cấp.

Bước 2: Dừng container N8n

Việc này sẽ làm gián đoạn các workflow đang chạy, vì vậy hãy đảm bảo rằng bạn đã hoàn tất tất cả các công việc quan trọng trước khi tiếp tục.

Lưu ý: bạn hay truy cập vào thư mục có chưa file docker-compose.yml trước khi chạy lệnh dưới đây.

docker-compose down

Bước 3: Cập nhật

Ở các hướng dẫn triển khai N8n với Docker hoặc Docker Compose trước đây của tôi đã có chỉ định phiên bản N8n luôn mới nhất trong Dockerfile FROM n8nio/n8n:latest, nên bạn chỉ cần thực hiện câu lệnh sau để Docker tự động tải về phiên bản mới nhất:

docker-compose pull

và sau đó khởi động lại container:

docker-compose up -d

Bước 4: Kiểm tra

Sau khi nâng cấp, hãy kiểm tra kỹ lưỡng hệ thống N8n của bạn để đảm bảo rằng tất cả các workflow và tích hợp hoạt động bình thường. Kiểm tra nhật ký lỗi và đảm bảo rằng không có vấn đề nào phát sinh sau quá trình nâng cấp.