Sao lưu Tự động Mã chèn thêm (Code Injection) của Squarespace lên GitHub - Quy trình làm việc n8n

Các nhà phát triển và thiết kế Squarespace phụ thuộc vào việc chèn mã tùy chỉnh.
Người dùng cần kiểm soát phiên bản (version control) cho các cấu hình trang web quan trọng.
Bất kỳ ai tìm kiếm giải pháp khôi phục thảm họa tự động, đáng tin cậy cho mã trang web của họ.
Người dùng thành thạo n8n đang tìm kiếm các ví dụ nâng cao về việc sử dụng framework các node của n8n với kịch bản tùy chỉnh.

Việc duy trì các đoạn mã chèn tùy chỉnh trên các nền tảng như Squarespace là rất quan trọng, nhưng những thay đổi này thường thiếu kiểm soát phiên bản gốc, gây rủi ro trong quá trình cập nhật hoặc di chuyển trang web. Workflow n8n mạnh mẽ này giải quyết vấn đề này bằng cách cung cấp giải pháp sao lưu tự động theo lịch trình thẳng tới GitHub. Mẫu n8n cụ thể này sử dụng các yêu cầu HTTP để kéo mã liên quan, và kịch bản node n8n tùy chỉnh (Cheerio) để làm sạch dữ liệu HTML một cách tỉ mỉ, đảm bảo chỉ có mã chèn thêm của bạn được lưu, chứ không phải mã mẫu (boilerplate) của nền tảng. Bằng cách thiết lập workflow n8n này, bạn sẽ yên tâm vì biết rằng các phần đầu trang và chân trang tùy chỉnh của bạn được lưu trữ an toàn và kiểm soát phiên bản sau mỗi hai giờ thông qua một trigger n8n đáng tin cậy.

Tự động hóa này bắt đầu bằng một trigger n8n theo lịch trình, được cấu hình để chạy mỗi hai giờ. Hoặc, nó có thể được chạy thủ công thông qua node n8n 'On clicking execute'.

1. Truy xuất Dữ liệu: Node n8n Get Squarespace data (một HTTP Request) truy vấn URL Squarespace được chỉ định bằng định dạng page-context để lấy cấu hình trang web hiện tại, bao gồm cả các điểm chèn mã đầu trang và chân trang.


2. Tách Dữ liệu & Siêu dữ liệu (Metadata): Dữ liệu được chia thành hai luồng: một cho đầu trang và một cho chân trang, sử dụng các node n8n 'Set' (Get Header Injection và Get Footer Injection). Các node này cũng trích xuất và đặt các siêu dữ liệu quan trọng như tên miền và dấu thời gian.


3. Làm sạch Mã: Các node n8n Clean up Footers và Clean up Headers sử dụng kịch bản JavaScript tùy chỉnh với Cheerio để loại bỏ các thành phần framework tiêu chuẩn của Squarespace, chỉ giữ lại mã chèn thêm thực sự tùy chỉnh.


4. Chuẩn bị cho GitHub: Node n8n Merge Injections kết hợp lại hai mục đã được làm sạch (dữ liệu đầu trang và dữ liệu chân trang). Sau đó, node n8n Globals áp dụng các cài đặt kho lưu trữ GitHub do người dùng xác định (chủ sở hữu, tên, đường dẫn).


5. Lưu trữ trên GitHub: Node n8n Loop Over Items xử lý dữ liệu đầu trang và chân trang một cách riêng biệt. Node n8n GitHub đầu tiên (Edit Injection data) cố gắng cập nhật tệp hiện có. Nếu hành động này thất bại (xảy ra khi tệp chưa tồn tại, được chỉ ra bởi node n8n If kiểm tra lỗi 'not found'), luồng sẽ chuyển đến node n8n Create Injection data, đảm bảo tệp được tạo lần đầu tiên. Logic có điều kiện này đảm bảo hoặc là cập nhật hoặc là tạo mới, duy trì lịch sử sao lưu nhất quán.

Để triển khai workflow n8n này một cách hiệu quả, hãy làm theo các bước sau:

1. Nhập (Import): Sao chép JSON workflow n8n được cung cấp và dán nó vào phiên bản n8n của bạn.


2. URL Squarespace: Tìm node n8n Get Squarespace data và cập nhật tham số URL thành tên miền chính của trang Squarespace của bạn.


3. Thông tin xác thực GitHub: Cấu hình thông tin xác thực API GitHub được yêu cầu bởi các node n8n Edit Injection data và Create Injection data. Việc này yêu cầu một Personal Access Token với quyền ghi (write permissions) trên kho lưu trữ.


4. Xác định Đường dẫn Kho lưu trữ: Mở node n8n Globals và cập nhật các cài đặt sau:

1. Kích hoạt: Đảm bảo trigger n8n Schedule Trigger đang hoạt động để cho phép sao lưu tự động.

Workflow n8n nâng cao này dựa vào một số loại node n8n cụ thể:

Schedule Trigger: Đóng vai trò là trigger n8n chính, khởi tạo quá trình sao lưu sau mỗi hai giờ. Node n8n có độ tin cậy cao cho các tác vụ định kỳ.
HTTP Request (Get Squarespace data): Lấy dữ liệu ngữ cảnh trang (page context) thô của Squarespace. Cấu hình quan trọng: Sử dụng tham số truy vấn ?format=page-context.
Set (Get Header/Footer Injection & Globals): Chủ yếu được sử dụng để thao tác dữ liệu. Các node Injection trích xuất nội dung thô và tạo ra siêu dữ liệu hỗ trợ (ID, tên miền). Node n8n Globals tập trung hóa các chi tiết cấu hình GitHub.
Code (Clean up Footers/Headers): Rất quan trọng cho việc làm sạch dữ liệu. Các triển khai node n8n kịch bản tùy chỉnh này sử dụng thư viện cheerio để phân tích cú pháp HTML và loại bỏ mã mẫu do Squarespace thêm vào, chỉ cô lập mã chèn thêm tùy chỉnh.
Merge: Kết hợp các luồng dữ liệu đầu trang và chân trang riêng biệt trở lại thành một luồng đầu vào duy nhất để xử lý tiếp theo.
Loop Over Items (Split In Batches): Đảm bảo rằng tệp đầu trang và tệp chân trang được xử lý tuần tự và độc lập bởi node n8n GitHub.

• GitHub (Edit/Create Injection data): Xử lý việc lưu trữ thực tế. Thao tác Edit cố gắng cập nhật tệp; nếu thất bại, node n8n If sẽ điều hướng thực thi đến thao tác Create, tạo điều kiện cho việc kiểm soát phiên bản liền mạch trong kho lưu trữ GitHub.