업데이트 전략과 롤백 완전 가이드

📖 이론10분

🛠️ 실습15분

🎯 미션5분

"실패를 대비하지 않는 것이 진정한 실패다."

— 드와이트 D. 아이젠하워 (Dwight D. Eisenhower, 미국 34대 대통령)

🎯 오늘의 학습 목표

안전한 n8n 업데이트 5단계 절차를 실행할 수 있다.
특정 버전으로 고정(Pinning)하는 방법을 이해하고 적용할 수 있다.
문제 발생 시 이전 버전으로 롤백할 수 있다.

💡 운영 중인 가게에서 갑자기 인테리어 공사를 시작하는 것과 같아요. 새 인테리어가 더 좋을 수 있지만, 공사 중에 손님이 불편을 겪을 수 있죠. 업데이트 전략의 핵심은 '언제, 어떻게 업데이트할지 규칙을 정해두는 것'입니다. Breaking Change란 이전 버전에서 잘 되던 기능이 새 버전에서 달라지거나 없어지는 변경을 말합니다.

Step 1 — 릴리즈 노트 확인

text

https://docs.n8n.io/changelog/

Step 2 — 데이터베이스 백업

bash

cd ~/n8n
docker compose exec postgres pg_dump \
  -U n8n_user n8n_db > backup_before_update_$(date +%Y%m%d_%H%M%S).sql
echo "백업 완료: $(ls -lh backup_*.sql | tail -1)"

Step 3 — 현재 버전 기록

bash

docker compose exec n8n n8n --version

Step 4 — 업데이트 실행

bash

docker compose pull
docker compose up -d --force-recreate

Step 5 — 동작 확인

bash

docker compose exec n8n n8n --version
docker compose logs n8n --tail=30

특정 버전 고정 (Pinning)

yaml

# 최신 버전 (기본)
image: n8nio/n8n:latest

# 특정 버전 고정 (프로덕션 환경 권장)
image: n8nio/n8n:1.94.1

💡 버전 목록은 hub.docker.com/r/n8nio/n8n/tags 에서 확인할 수 있어요.

문제가 생겼을 때 롤백하기

bash

cd ~/n8n
# 1. n8n 중지
docker compose down

# 2. docker-compose.yml에서 이미지를 이전 버전으로 변경
nano docker-compose.yml
# image: n8nio/n8n:1.93.0 ← 이전 버전으로 수정

# 3. 재시작
docker compose up -d

📊 업데이트 주기 추천

환경	업데이트 주기	이유
개인 테스트 서버	새 버전 즉시	최신 기능 빨리 체험
소규모 팀 운영	2~4주에 1회	안정성과 최신 기능의 균형
기업 운영	1~2개월에 1회	충분한 테스트 후 적용
금융/의료 등	분기 1회 + 긴급 패치만	변경 최소화, 안정성 우선

🛠️ DAY 6 실습

Step 1현재 버전 확인 및 릴리즈 노트 검토

docker compose exec n8n n8n --version 으로 현재 버전 확인
https://docs.n8n.io/changelog/ 에서 최신 버전까지 변경 사항 확인
Breaking Change 여부 확인 및 메모

Step 2백업 후 업데이트

pg_dump 명령으로 DB 백업 파일 생성 및 크기 확인
docker compose pull && docker compose up -d --force-recreate 실행
업데이트 후 버전 확인 및 주요 워크플로우 수동 실행 테스트

Step 3업데이트 정책 문서화

업데이트 주기 결정 (환경에 맞게)
담당자, 확인 URL, 백업 위치, 롤백 방법을 문서로 작성
~/n8n/UPDATE_POLICY.md 파일로 저장

🚀 DAY 6 미션

n8n을 안전하게 업데이트하고 업데이트 정책 문서를 작성하세요.

☑️ 미션 체크리스트

업데이트 전 DB 백업 완료
릴리즈 노트 Breaking Change 확인
업데이트 후 n8n 정상 동작 확인
업데이트 정책 문서 작성 완료

💡 힌트: 메이저 버전을 건너뛰면 마이그레이션 오류가 발생할 수 있어요. 중간 버전을 거쳐서 업데이트하세요.

🎯 성공 기준: 최신 버전으로 업데이트되고 업데이트 정책 문서가 작성된 상태

← 이전

n8n 1.90+ 핵심 변경사항 이해하기

PART 1 미니 프로젝트: 나만의 n8n 서버 완전 구축

← 목차로 돌아가기