GitHub 이슈 관리 및 Notion 동기화 - n8n 워크플로우

소프트웨어 개발팀: GitHub에서 관리하는 버그 추적 및 기능 요청을 Notion과 같은 프로젝트 관리 툴로 일원화해야 하는 팀.
프로젝트 관리자(PM): GitHub에서의 개발자 활동을 기반으로 한 모든 프로젝트 상태 업데이트에 대해 Notion을 단일 정보 소스(Single Source of Truth)로 활용하기를 선호하는 분.

• n8n 사용자: GitHub 및 Notion n8n 노드 통합을 사용하여 복잡한 분기 로직과 데이터베이스 동기화를 입증하는 고급 n8n 템플릿을 찾는 분들.

플랫폼 전반에 걸쳐 개발 작업을 관리하면 정보 사일로(고립) 현상이 발생할 수 있습니다. 이 고성능 n8n 워크플로우는 GitHub 이슈와 Notion 데이터베이스 간에 강력하고 양방향 미러링을 구축하여 이 문제를 해결합니다. GitHub 이슈에서 생성, 수정, 삭제 등 어떤 작업이 이루어지든 이 n8n 자동화는 Notion의 해당 레코드를 즉시 업데이트합니다. 이 강력한 n8n 워크플로우는 조건부 로직과 사용자 지정 스크립팅을 활용하여 기존 Notion 페이지를 안정적으로 찾고 수정하므로, 플랫폼 간 데이터 동기화를 위한 강력한 노코드 솔루션을 제공합니다. n8n 트리거의 강력한 기능을 활용하는 이 템플릿은 효율적인 DevOps 및 프로젝트 관리에 필수적입니다.

전용 GitHub n8n 트리거 노드 덕분에 지정된 이벤트가 GitHub에서 발생하는 즉시 프로세스가 시작됩니다.

1. 트리거 및 초기 확인: n8n 트리거가 특정 GitHub 리포지토리의 이슈 이벤트를 모니터링합니다. 데이터 페이로드(payload)가 초기 IF n8n 노드로 전달되어 GitHub 이슈에서 수행된 작업('opened', 'edited', 'closed' 등)을 검사합니다.


2. 새 이슈 생성: 작업이 'opened'인 경우, 플로우는 Notion Create database page n8n 노드로 진행되어 새 이슈의 제목, ID, URL을 구성된 Notion 데이터베이스에 직접 기록합니다.


3. 수정 처리: 작업이 'opened'가 아닌 경우, n8n 워크플로우는 Create custom Notion filters 함수 n8n 노드로 이동합니다. 이 노드는 GitHub 이슈 ID를 사용하여 기존 Notion 페이지를 찾기 위한 JSON 필터 페이로드를 동적으로 생성합니다.


4. 레코드 찾기: Find database page n8n 노드는 이 사용자 지정 필터를 사용하여 기존 Notion 데이터베이스 항목의 내부 ID를 검색합니다.


5. 작업 라우팅 (Switch): 중앙의 Switch n8n 노드는 수행된 특정 작업('edited', 'deleted', 'closed', 'reopened')을 평가합니다.


6. 업데이트 실행: 플로우는 해당 Edit issue(제목 업데이트), Delete issue(페이지 보관 처리), Close issue('Closed' 체크박스를 true로 설정) 또는 Reopen issue('Closed' 체크박스 해제)와 같은 관련 Notion n8n 노드로 분기됩니다. 이를 통해 Notion 레코드가 GitHub 이슈의 정확한 상태를 반영하게 되어 이 포괄적인 n8n 워크플로우의 동기화 주기가 완료됩니다.

이 n8n 템플릿을 배포하려면 다음 단계를 따르세요:

1. n8n 워크플로우 가져오기: 제공된 JSON 데이터를 복사하여 n8n 인스턴스의 'Workflows' 화면에서 'New' 버튼과 'Import from JSON'을 사용하여 가져옵니다.


2. 자격 증명 구성: GitHub 및 Notion n8n 노드 연결에 대한 자리 표시자 자격 증명을 개인 API 키로 업데이트하세요.

1. 데이터베이스 ID 지정: 모든 Notion n8n 노드(Create database page, Find database page 등)에서 자리 표시자 데이터베이스 ID(5026700b-6693-473a-8100-8cc6ddef62a6)를 실제 Notion 데이터베이스 ID로 바꾸세요.


2. GitHub 트리거 구성: Trigger on issues n8n 트리거에서 Owner 및 Repository 필드를 GitHub 설정과 일치하도록 업데이트하세요.


3. 활성화: 구성이 완료되면 n8n 워크플로우를 활성화하여 실시간 동기화를 시작합니다.

Trigger on issues (GitHub Trigger n8n trigger):
기능: 특정 GitHub 리포지토리의 issues 이벤트를 수신 대기하는 시작점 역할을 합니다.
주요 구성: John-n8n/DemoRepo에서 이벤트를 감시하도록 구성되었으며 특히 issues 이벤트 유형을 대상으로 합니다.
IF (n8n node):
기능: GitHub 이슈 작업에 따라 플로우의 경로를 결정합니다. 'opened'(새 이슈)와 다른 모든 작업(수정 사항) 경로를 분기합니다.
주요 구성: body.action이 opened와 일치하는지 확인합니다.
Create custom Notion filters (Function n8n node):
기능: 수정 경로를 위한 핵심 n8n 노드입니다. 사용자 지정 JavaScript를 사용하여 'Issue ID' 속성이 수신된 GitHub 이슈 ID와 일치하는 페이지를 검색하기 위한 Notion API 필터 JSON 페이로드를 구성합니다.
Find database page (Notion n8n node):
기능: 이전 n8n 노드에서 생성된 필터를 실행하여 기존 Notion 레코드의 고유한 pageId를 검색합니다.
주요 구성: 검색을 수행하기 위해 Function n8n 노드에서 입력된 JSON 필터를 사용합니다.
Switch (n8n node):
기능: GitHub 작업(edited, deleted, closed, reopened)을 기반으로 Notion에서 필요한 후속 조치를 결정합니다. 이 고급 n8n 워크플로우의 핵심 구성 요소입니다.
주요 구성: GitHub 작업 문자열을 네 가지 가능한 결과와 비교하여 올바른 업데이트 n8n 노드로 플로우를 라우팅합니다.
Notion Nodes (Create/Edit/Delete/Close/Reopen issue):
기능: Notion 데이터베이스 페이지에 해당 상태 변경 사항을 적용하는 역할을 하는 Notion n8n 노드 모음입니다(예: 이슈가 삭제된 경우 페이지 보관 처리, 이슈가 열리거나 닫힌 경우 체크박스 상태 업데이트).