Skip to main content

롤백 절차

배포 후 문제 발생 시 이전 버전으로 복구하는 방법입니다.

빠른 롤백​

make rollback NAME=myapp

바로 이전 릴리즈로 롤백됩니다.

특정 버전으로 롤백​

# 릴리즈 목록 확인
make release-list NAME=myapp

# 특정 버전으로 배포
make deploy NAME=myapp VERSION=251216-1200

롤백 원리​

심볼릭 링크 변경으로 즉시 롤백:

# 현재 상태
live/myapp → releases/myapp/251218-1400

# 롤백 후
live/myapp → releases/myapp/251217-0900
왜 빠른가?

파일 복사 없이 심볼릭 링크만 변경하므로 수 초 내 완료됩니다.

롤백 시 주의사항​

DB 마이그레이션​

마이그레이션 롤백 불가

이미 적용된 마이그레이션은 자동으로 롤백되지 않습니다.

해결 방법:

  1. 새 마이그레이션으로 수정
  2. 수동 롤백 (php artisan migrate:rollback)
  3. DB 백업에서 복원

캐시/세션​

롤백 후 캐시 클리어:

make shell NAME=myapp
php artisan cache:clear
php artisan config:clear

롤백 체크리스트​

  • 문제 증상 파악
  • 릴리즈 목록에서 안정 버전 확인
  • 롤백 실행
  • 서비스 정상 확인
  • 원인 분석 후 수정

비상 롤백 (수동)​

Makefile이 동작하지 않을 경우:

# 심볼릭 링크 직접 변경
cd live
rm myapp
ln -s ../releases/myapp/251216-1200 myapp

# 웹 서버 재시작 (필요시)
sudo systemctl reload nginx

예방 조치​

배포 전 백업​

make backup NAME=myapp
make release NAME=myapp
make deploy NAME=myapp

스테이징 테스트​

프로덕션 배포 전 스테이징 환경에서 테스트.

릴리즈 유지​

최소 3-5개 이전 릴리즈 유지:

make release-clean NAME=myapp KEEP=5