Sao lưu Workflow Tự động lên GitHub kèm Kiểm tra Khác biệt - Quy trình làm việc n8n

Quản trị viên n8n và các đội ngũ DevOps cần kiểm soát phiên bản đáng tin cậy cho tất cả cấu hình workflow n8n đang chạy (production).
Người dùng tìm kiếm các mẫu (template) n8n nâng cao sử dụng workflow đệ quy tự gọi (self-calling recursive workflows).

• Lập trình viên cần một giải pháp sao lưu tự động, tập trung cho instance n8n của họ.

Đây là giải pháp workflow n8n bảo trì quan trọng, được thiết kế cho các tổ chức vận hành n8n ở môi trường production. Nó giải quyết vấn đề thất thoát workflow và sai lệch cấu hình bằng cách cung cấp các bản sao lưu mạnh mẽ, có kiểm soát phiên bản cho mọi tệp workflow n8n (ID.json) lên GitHub. Hệ thống sử dụng phương pháp node n8n đệ quy tinh vi để lặp lại việc lấy và so sánh trạng thái hiện tại của workflow đang chạy với phiên bản đã lưu trữ trong repository.

A key benefit of this n8n workflow is its efficiency. By employing a custom comparison logic within a dedicated Code n8n node, it only interacts with the GitHub API to perform an update if an actual functional difference is detected. This minimizes unnecessary API calls and ensures that your repository history is clean and meaningful. Using this n8n workflow as a foundation, you can guarantee your automation logic is consistently backed up and tracked.

Quy trình được bắt đầu thủ công bằng cách sử dụng trigger n8n On clicking 'execute' hoặc tự động thông qua node Schedule Trigger n8n (cấu hình chạy hàng ngày, thường là 7 giờ sáng).

1. Khám phá Workflow: Node n8n n8n truy xuất danh sách đầy đủ tất cả các workflow đã xuất bản trên instance hiện tại.


2. Lặp đệ quy: Node Loop Over Items n8n và node Execute Workflow n8n tiếp theo thiết lập một vòng lặp đệ quy tự gọi. Mẫu này được triển khai để xử lý hàng trăm workflow một cách hiệu quả bằng cách xử lý từng mục như một lần gọi workflow phụ.


3. Ngữ cảnh và Biến toàn cục: Bên trong workflow phụ, node Globals n8n xác định các tham số GitHub mục tiêu (owner, repo, và định đường dẫn động dựa trên thẻ (tag) của workflow, được xử lý bởi các node n8n tag? và / trước đó).


4. Kiểm tra Bản sao lưu Hiện có: Node GitHub Get file data n8n cố gắng lấy tệp JSON hiện có từ repository. Điều quan trọng là nó sẽ tiếp tục nếu thất bại trong trường hợp tệp đó mới. Nếu tệp quá lớn để lấy trực tiếp, If file too large sẽ chuyển mục đó sang Get File (HTTP Request) để tải nội dung qua URL được cung cấp.


5. Phân tích Khác biệt: Node Merge Items kết hợp dữ liệu workflow và dữ liệu tệp GitHub. Sau đó, node Code n8n isDiffOrNew giải mã nội dung tệp hiện có (nếu có), sắp xếp các khóa trong cả đối tượng JSON cũ và mới, và thực hiện so sánh. Nó gán một trạng thái: "same" (giống nhau), "different" (khác biệt), hoặc "new" (mới).


6. Thực thi Hành động: Node Switch n8n Check Status điều hướng luồng dựa trên trạng thái được xác định. Nếu trạng thái là "new", node GitHub Create new file sẽ thực thi. Nếu trạng thái là "different", node GitHub Edit existing file sẽ cập nhật nội dung. Nếu trạng thái là "same", workflow n8n sẽ hoàn thành mục đó mà không cần hành động gì.

Để triển khai workflow n8n mạnh mẽ này, hãy làm theo các bước sau:

1. Nhập (Import): Nhập JSON workflow n8n này vào instance n8n của bạn.


2. Thông tin xác thực (Credentials): Thiết lập hoặc chọn thông tin xác thực GitHub API của bạn trong các node n8n Get file data, Create new file, và Edit existing file. Đảm bảo mã thông báo (token) xác thực có quyền truy cập đọc/ghi repository.


3. Thông tin xác thực API: Thiết lập thông tin xác thực n8n API của bạn trong node n8n chính để nó có thể liệt kê các workflow trên instance.


4. Cấu hình: Mở node Globals n8n và cập nhật các tham số trong tab Assignments (Chỉ định):

1. Thực thi: Bạn có thể chạy workflow thủ công thông qua node Manual Trigger n8n hoặc dựa vào trigger Schedule Trigger n8n đã được cấu hình để tự động hóa hàng ngày.

Workflow n8n này sử dụng một số node chính để đạt được mục tiêu của nó:

Schedule Trigger / Manual Trigger (trigger n8n): Khởi tạo quy trình sao lưu, cung cấp sự linh hoạt cho các lần chạy theo lịch trình hoặc đột xuất.
n8n (node n8n): Truy xuất danh sách tất cả các workflow từ instance n8n, cung cấp dữ liệu đầu vào cho vòng lặp chính.
Execute Workflow (node n8n): Rất cần thiết cho mẫu workflow phụ đệ quy, cho phép lặp lại hiệu quả trên tất cả các workflow mà không làm quá tải bộ nhớ.
Globals (node Set n8n): Chứa các biến cấu hình quan trọng (chi tiết repository GitHub) cần được chỉnh sửa trước khi workflow n8n được kích hoạt.
Get file data (node GitHub n8n): Cố gắng truy xuất tệp sao lưu workflow hiện có từ GitHub, rất quan trọng cho bước so sánh. Được cấu hình để tiếp tục khi thất bại (continue on fail).
If file too large (node If n8n) & Get File (node HTTP Request n8n): Xử lý các trường hợp GitHub trả về URL tải xuống thay vì nội dung, đảm bảo các tệp workflow lớn được truy xuất thành công.
isDiffOrNew (node Code n8n): Chứa logic viết mã (scripting) tùy chỉnh cốt lõi. Node n8n này giải mã nội dung base64, sắp xếp các khóa JSON và so sánh các đối tượng đã chuyển thành chuỗi (stringified) để xác định xem đã có thay đổi đáng kể nào xảy ra chưa, sau đó thiết lập thuộc tính githubstatus.
Check Status (node Switch n8n): Điều hướng luồng dựa trên githubstatus được tính toán bởi node Code n8n (new, different, hoặc same).

• Create new file / Edit existing file (node GitHub n8n): Thực hiện các thao tác API cần thiết để commit dữ liệu JSON workflow n8n hiện tại vào repository, sử dụng thao tác thích hợp dựa trên trạng thái.