인스턴스 간 워크플로우 동기화 유틸리티 - n8n 워크플로우

여러 스테이징 및 프로덕션 n8n 환경을 관리하는 자동화 아키텍트
서로 다른 자체 호스팅 인스턴스 전반에 걸쳐 일관된 n8n 워크플로우 업데이트를 배포해야 하는 기술팀
특정 n8n 템플릿을 계정 간에 백업하거나 이동하려는 사용자
관리 및 DevSecOps 작업을 위해 n8n API를 활용하는 모든 사용자

여러 n8n 인스턴스를 관리하다 보면 동기화 문제가 자주 발생합니다. 복잡한 n8n 워크플로우 정의를 수동으로 내보내고 가져오는 작업은 시간이 많이 걸리고 오류가 발생하기 쉽습니다. 이 특화된 n8n 워크플로우는 소스 인스턴스에는 있지만 대상 인스턴스에는 누락된 워크플로우를 자동으로 식별하고 복제하여 이러한 문제를 해결합니다.

기본 제공되는 n8n 노드 기능과 Merge 노드 내의 SQL 비교 로직을 활용하여 높은 정확도의 동기화를 보장합니다. 누락된 n8n 워크플로우를 복제한 후, 고급 HTTP Request 단계를 사용하여 새 워크플로우를 대상 인스턴스의 특정 프로젝트에 선택적으로 할당함으로써 새로운 n8n 템플릿 배포에 대한 완벽한 관리 권한을 제공합니다.

이 자동화는 'When clicking Test workflow' n8n 트리거로 시작됩니다.

1. 워크플로우 검색: n8n 워크플로우는 즉시 분기되어 소스 인스턴스의 워크플로우는 GET - Workflows n8n 노드에서, 대상 인스턴스의 워크플로우는 GET - Destination Workflows n8n 노드에서 동시에 쿼리합니다.


2. 데이터 준비: Split Out Workflows n8n 노드 변형을 사용하여 두 인스턴스의 데이터를 분리합니다.


3. 누락된 워크플로우 식별: 핵심 로직은 Merge Workflows n8n 노드에 있으며, SQL LEFT JOIN 비교를 사용합니다. 이 노드는 소스(입력 1)의 워크플로우 이름과 대상(입력 2)을 비교합니다. WHERE input2.name IS NULL 절을 통해 대상에는 없는 소스 내의 워크플로우만 전달되도록 보장합니다.


4. 배치 처리: Loop Over Items n8n 노드가 식별된 워크플로우를 소규모 배치(배치당 5개 항목)로 처리합니다.


5. 워크플로우 생성: 누락된 각 워크플로우에 대해 CREATE - Workflow n8n 노드는 대상 인스턴스의 n8n API 자격 증명을 활용하여 노드, 연결 및 설정을 포함한 누락된 n8n 워크플로우의 전체 JSON 정의를 다시 생성합니다.


6. 프로젝트 할당 (선택 사항): 생성 후, HTTP Requests 및 필터링을 사용하여 대상 인스턴스에서 대상 프로젝트 ID를 동적으로 찾습니다. 마지막으로 PUT - Workflow in Project n8n 노드가 새로 생성된 n8n 워크플로우를 지정된 프로젝트로 이동시킵니다.

이 강력한 n8n 워크플로우를 배포하고 n8n 템플릿을 관리하려면 다음 단계를 따르세요.

1. JSON 가져오기: 제공된 n8n 워크플로우 JSON 코드를 복사하여 '새로 만들기(New)' 메뉴 -> 'JSON에서 가져오기(Import from JSON)'를 사용하여 n8n 인스턴스로 가져옵니다.


2. 소스 인스턴스 자격 증명 설정: GET - Workflows n8n 노드를 찾습니다. 'n8n API' 자격 증명('템플릿에서는 'AK n8n original account'로 표시됨')을 소스 n8n 인스턴스를 가리키도록 업데이트합니다.


3. 대상 인스턴스 자격 증명 설정: GET - Destination Workflows 및 CREATE - Workflow에서 사용되는 'n8n API' 자격 증명('템플릿에서는 'AlexK1919 n8n ent account'로 표시됨')을 대상 n8n 인스턴스를 가리키도록 업데이트합니다.


4. API 키: 구성된 자격 증명이 n8n 워크플로우 항목을 나열하고 생성하는 데 필요한 권한(일반적으로 '모두(All)')을 가지고 있는지 확인합니다.


5. 프로젝트 필터 구성 (선택 사항): 프로젝트 할당 기능을 사용하려는 경우, Filter Project n8n 노드로 이동하여 대상 인스턴스에서 새 n8n 워크플로우를 전송하려는 프로젝트의 정확한 이름과 일치하도록 조건문의 rightValue를 변경합니다.

이 n8n 워크플로우는 핵심 노드와 n8n API에 의존합니다:

'Test workflow' 클릭 시 (수동 트리거): 클로닝 프로세스를 시작하기 위한 필수 n8n 트리거입니다. 즉각적인 동기화 테스트에 사용됩니다.
GET - Workflows / GET - Destination Workflows (n8n 노드): n8n API 리소스를 사용하여 해당 소스 및 대상 인스턴스에서 모든 워크플로우를 검색합니다.
Merge Workflows (Merge 노드): 로직 제어에 매우 중요합니다. SQL LEFT JOIN 모드를 사용한 결합을 통해 워크플로우 이름을 기준으로 대상 인스턴스에 이미 존재하는 n8n 워크플로우를 필터링합니다.
CREATE - Workflow (n8n 노드): 최종 실행 노드로, 누락된 n8n 워크플로우의 전체 JSON 정의를 대상 인스턴스 API로 포스팅하는 역할을 합니다.
Filter Project (Filter 노드): 프로젝트 이름(예: 'z Original n8n Workflows from AlexK1919')을 일치시켜 대상 인스턴스의 특정 프로젝트 ID를 식별하는 데 사용됩니다.
PUT - Workflow in Project (HTTP Request 노드): 새로 생성된 n8n 워크플로우를 특정 프로젝트 컨테이너로 전송하기 위해 API 호출을 수행하는 고급 유틸리티 n8n 노드입니다.