Đồng bộ Hai chiều để Kiểm soát Phiên bản Workflow bằng GitHub - Quy trình làm việc n8n

Nhà phát triển tự động hóa cần kiểm soát phiên bản đáng tin cậy cho logic workflow n8n phức tạp của họ.
Các nhóm sử dụng n8n yêu cầu môi trường được đồng bộ hóa và quyền truy cập cộng tác vào các mẫu n8n.
Người dùng cần sao lưu lịch trình mạnh mẽ cho cấu hình instance n8n của họ.
Người dùng kỹ thuật tìm kiếm các ví dụ nâng cao về điều khiển luồng và tương tác API trong một workflow n8n.

Workflow n8n toàn diện này giải quyết nhu cầu thiết yếu về kiểm soát phiên bản và sao lưu đáng tin cậy cho các mẫu và quy trình tự động hóa n8n quan trọng. Các nhà phát triển và người dùng n8n nâng cao thường gặp khó khăn trong việc giữ cho các định nghĩa workflow n8n cục bộ của họ đồng bộ với các kho lưu trữ bên ngoài, gây khó khăn cho việc cộng tác và phục hồi sau thảm họa. Mẫu n8n chuyên biệt này sử dụng phương pháp hai chiều tinh vi: nó so sánh từng workflow n8n cục bộ với tệp tương ứng trên GitHub. Nếu một workflow chỉ tồn tại trong n8n, nó sẽ tải lên GitHub. Nếu một workflow chỉ tồn tại trên GitHub, nó sẽ nhập vào n8n. Quan trọng nhất, nó giải quyết xung đột phiên bản một cách thông minh bằng cách kiểm tra dấu thời gian, đảm bảo phiên bản mới nhất (dù là cục bộ hay từ xa) được ưu tiên. Logic node n8n mạnh mẽ này đảm bảo các quy trình tự động hóa của bạn luôn được lập phiên bản.

1. Quy trình được bắt đầu bởi một trigger n8n, cụ thể là Schedule Trigger (Trigger theo Lịch trình), được thiết lập để chạy hàng tuần (vào mỗi thứ Hai).


2. Workflow trước tiên sử dụng node Set n8n để xác định các biến cấu hình quan trọng: thông tin xác thực GitHub, tên kho lưu trữ và đường dẫn thư mục cụ thể nơi lưu trữ các tệp JSON của workflow n8n.


3. Hai nhánh song song bắt đầu: một nhánh sử dụng node n8n nội bộ để truy xuất siêu dữ liệu cho tất cả các workflow n8n cục bộ đang hoạt động, và nhánh kia sử dụng node n8n GitHub để liệt kê tất cả các tệp workflow hiện có trong kho lưu trữ.


4. Các tệp truy xuất từ GitHub sau đó được kéo về riêng lẻ và giải mã từ base64 sang định dạng JSON chuẩn, có thể sử dụng được.


5. Phần trung tâm là node Compare Datasets n8n, so sánh danh sách các workflow n8n cục bộ (Đầu vào A) với các tệp GitHub đã giải mã (Đầu vào B) bằng cách sử dụng ID workflow làm khóa duy nhất, chia luồng thành bốn đường dẫn: Chỉ có trong n8n, Chỉ có trong GitHub, Khác biệt, và Giống nhau.


6. Workflow Cục bộ Mới (Chỉ có trong n8n): Các workflow chỉ tồn tại cục bộ được chuyển đổi sang base64 và tải lên GitHub bằng cách sử dụng node n8n GitHub, tạo một tệp mới.


7. Workflow Từ xa Mới (Chỉ có trong GitHub): Các workflow chỉ tồn tại trên GitHub được nhập vào instance n8n bằng thao tác node n8n chuyên dụng: Create workflow (Tạo workflow).


8. Xung đột Phiên bản (Khác biệt): Một node If n8n kiểm tra dấu thời gian updatedAt. Nếu phiên bản GitHub mới hơn, phiên bản GitHub sẽ được dùng để cập nhật workflow n8n cục bộ thông qua node Update workflow n8n. Nếu workflow n8n cục bộ mới hơn, nó sẽ được chuẩn bị, mã hóa và tải lên để ghi đè tệp trên GitHub, đảm bảo các thay đổi mới nhất được lưu. Khả năng so sánh node n8n mạnh mẽ này là chìa khóa để duy trì sự đồng bộ hóa.

1. Nhập workflow n8n: Sao chép JSON được cung cấp và nhập trực tiếp vào instance n8n của bạn.


2. Thông tin xác thực GitHub: Bạn phải cấu hình thông tin xác thực GitHub có quyền đọc và ghi vào kho lưu trữ đích.


3. node Set GitHub Details n8n: Mở node "Set GitHub Details" n8n và điền các giá trị bắt buộc sau:

1. Thông tin xác thực n8n: Đảm bảo bạn đã cấu hình thông tin xác thực API n8n đang hoạt động cho phép workflow tương tác với instance n8n cục bộ (liệt kê, tạo và cập nhật các workflow).


2. Kích hoạt: Sau khi áp dụng thông tin xác thực và cài đặt, hãy kích hoạt trigger n8n để bắt đầu quá trình đồng bộ theo lịch trình.

Schedule Trigger (trigger n8n): Trigger n8n chính chạy toàn bộ quy trình đồng bộ theo lịch trình hàng tuần.
Set GitHub Details (node Set n8n): Được sử dụng để tiêm các biến toàn cục (đường dẫn kho lưu trữ, tên tài khoản) cần thiết cho các hoạt động của node n8n GitHub tiếp theo.
n8n (node n8n): Được sử dụng theo ba cách chính: 1) Liệt kê tất cả các workflow n8n đang hoạt động. 2) Tạo các workflow mới chỉ tìm thấy trên GitHub. 3) Cập nhật các workflow hiện có trong n8n nếu phiên bản GitHub mới hơn.
GitHub (node n8n): Xử lý các thao tác tệp trên kho lưu trữ, bao gồm liệt kê nội dung, truy xuất các tệp riêng lẻ, tải lên các tệp workflow mới và chỉnh sửa các tệp hiện có.
Compare Datasets (node n8n): node ra quyết định cốt lõi. Nó so sánh các tập dữ liệu workflow cục bộ và từ xa dựa trên ID để xác định các mẫu n8n mới, đã xóa hoặc khác biệt.
If n8n before GitHub (node If n8n): Thực thi logic giải quyết xung đột, xác định phiên bản workflow n8n nào ưu việt hơn bằng cách so sánh dấu thời gian.

• Convert to File / Extract From File (các node n8n): Thiết yếu để chuẩn bị dữ liệu JSON của workflow n8n (ví dụ: khi workflow cục bộ mới hơn) bằng cách chuyển đổi nó sang định dạng nhị phân và mã hóa thành base64 để tải lên API GitHub.