발행일: 2026-10-06(화) 11:44
홈›도서›하루 30분 n8n ④›워크플로우 버전 관리와 소스 컨트롤
DAY 17★★★

워크플로우 버전 관리와 소스 컨트롤

📖 이론10분
🛠️ 실습15분
🎯 미션5분

"언제든 되돌아올 수 있다는 확신이 있어야 과감하게 앞으로 나아갈 수 있다."

— 라이너스 토르발스 (Linus Torvalds, Linux·Git 창시자)
🎯 오늘의 학습 목표
  • 소스 컨트롤(Git)로 워크플로우 변경 이력을 추적할 수 있다.
  • GitHub Private 저장소에 n8n 워크플로우를 연동할 수 있다.
  • 개발/운영 브랜치 전략을 수립하고 적용할 수 있다.
소스 컨트롤이 왜 필요한가?

소스 컨트롤(Source Control)은 Git을 이용해 워크플로우 변경 이력을 추적하는 기능이에요. 워크플로우 변경 이력 추적, 실수 롤백, 개발/운영 브랜치 분리, 팀 협업이 가능해집니다.

Step 1 — GitHub 저장소 만들기
text
GitHub에 새 저장소를 만드세요.
이름: my-company-n8n-workflows
반드시 Private(비공개)으로 설정합니다.
Step 2 — SSH 키 생성 및 GitHub에 등록
bash
ssh-keygen -t ed25519 -C "n8n-git-sync"
cat ~/.ssh/id_ed25519.pub
💡 GitHub 저장소 → Settings → Deploy Keys → Add deploy key 에서 공개키를 붙여넣고 "Allow write access"를 체크합니다.
Step 3 — n8n에서 Git 연동 설정
text
n8n Settings → Source Control → Configure 클릭 후 아래를 입력합니다.

Repository URL: git@github.com:username/my-company-n8n-workflows.git
Branch: main
SSH Private Key: (cat ~/.ssh/id_ed25519 의 내용 붙여넣기)

Connect 버튼을 클릭 후 연결을 확인합니다.
개발/운영 브랜치 전략
text
main 브랜치      ← 운영 서버가 참조
       ↑ merge
develop 브랜치   ← 개발 서버가 참조
       ↑ 작업
feature/xxx 브랜치 ← 개별 기능 개발
🛠️ DAY 17 실습
Step 1GitHub Private 저장소 생성
  1. GitHub에 로그인 후 New repository 클릭
  2. 이름: my-company-n8n-workflows, Private 선택
  3. README 초기화 체크 후 Create repository
Step 2서버에서 SSH 키 생성 및 등록
  1. ssh-keygen -t ed25519 -C "n8n-git-sync" 실행
  2. cat ~/.ssh/id_ed25519.pub 로 공개키 복사
  3. GitHub 저장소 → Settings → Deploy Keys → Add deploy key → 붙여넣기 + Allow write access 체크
Step 3n8n 소스 컨트롤 연동
  1. n8n Settings → Source Control → Configure
  2. Repository URL, Branch(main), SSH Private Key 입력
  3. Connect 후 Push changes 로 첫 번째 커밋 확인
🚀 DAY 17 미션

n8n 소스 컨트롤을 GitHub Private 저장소에 연동하고, 워크플로우 1개를 수정한 뒤 Push하여 GitHub에 변경 이력이 남는 것을 확인하세요.

☑️ 미션 체크리스트
  • GitHub Private 저장소 생성 완료
  • SSH 키 생성 및 Deploy Keys 등록 완료
  • n8n Source Control 연동 성공
  • 워크플로우 수정 후 Push → GitHub 커밋 내역 확인
💡 힌트: SSH 키는 서버에서 생성해야 합니다. 로컬 PC가 아닌 VPS 터미널에서 실행하세요.
🎯 성공 기준: GitHub 저장소에 .n8n 폴더와 워크플로우 JSON 파일이 커밋된 상태
← 이전
프로젝트 구조 설계와 팀 온보딩
다음 →
워크플로우 표준화와 팀 가이드라인
← 목차로 돌아가기