안전한 버전 업그레이드 — 단계별 업데이트 SOP

💡 Breaking Changes는 기존 워크플로우를 망가뜨릴 수 있는 변경사항입니다. 새 기능보다 먼저 Breaking Changes를 확인해야 업그레이드 후 발생할 수 있는 문제를 미리 파악하고 대응할 수 있습니다.

💡 :latest 태그는 언제 바뀔지 알 수 없어 예기치 않은 자동 업그레이드가 발생할 수 있습니다. 반드시 1.25.3과 같이 정확한 버전을 명시해야 안전한 운영이 가능합니다.

💡 n8n은 시작 시 TypeORM 마이그레이션을 자동으로 실행합니다. 마이그레이션 실패 시 자동 롤백은 되지 않으므로, 반드시 사전에 DB 백업을 완료해야 합니다.

💡 올바른 업그레이드 순서: 1.현재 버전 기록 → 2.백업 → 3.새 이미지 pull → 4.기존 컨테이너 중지 → 5.새 컨테이너 시작 → 6.마이그레이션 확인 → 7.동작 테스트. 새 이미지 pull 후에는 기존 컨테이너를 중지해야 합니다.

💡 시맨틱 버전 형식 MAJOR.MINOR.PATCH에서 1.25.3의 경우: 1은 Major(대규모 변경), 25는 Minor(기능 추가), 3은 Patch(버그 수정)입니다. 패치 버전 업데이트가 가장 안전하며, 메이저 버전 업데이트는 가장 신중하게 접근해야 합니다.