롤백 — 5분 안에 이전 버전으로 되돌리기

💡 UI에 새로운 기능 버튼이 추가되는 것은 정상적인 업데이트 결과입니다. 즉시 롤백이 필요한 상황은 컨테이너 재시작 반복, 마이그레이션 실패, UI 접속 불가 등 실제 장애 상황입니다.

💡 n8n의 DB 마이그레이션은 TypeORM을 사용하며 대부분 비가역적입니다. 한 번 실행된 마이그레이션은 되돌리기 어려우며, 컬럼 삭제나 데이터 변환은 복구가 불가능할 수 있습니다. 따라서 업그레이드 전 반드시 DB 백업이 필요합니다.

💡 이전 버전 이미지가 로컬에 캐시되어 있으면 Docker Hub에서 다시 다운로드할 필요 없이 즉시 사용 가능합니다. 이는 롤백 속도를 크게 높이고 네트워크 문제 시에도 롤백이 가능하게 합니다. 5분 안에 롤백하려면 이미지 로컬 캐시가 필수입니다.

💡 롤백 후 즉시 최신 버전으로 다시 업그레이드하는 것은 잘못된 접근입니다. 원인을 파악하지 않고 재업그레이드하면 같은 문제가 반복됩니다. 에러 로그 분석, 커뮤니티 이슈 확인, 패치 버전 대기 등을 거친 후 계획적으로 재업그레이드해야 합니다.

💡 Harbor(내부 이미지 레지스트리)를 사용하면 특정 버전의 이미지를 내부에 영구 보관할 수 있습니다. Docker Hub에서 해당 버전이 삭제되거나 접근이 제한되어도 언제든 롤백 가능합니다. 또한 내부 네트워크에서 pull하므로 속도도 빠릅니다.