Justin-book

프론트엔드 배포 및 검증 체크리스트 (Frontend Deployment Checklist)

2025-10-27

요약

  • 안정적인 배포는 품질의 마지막 단계다.
  • 본 문서는 FE 배포 절차, 검증 항목, 사후 점검 리스트를 제공한다.
  • 목표: 안정적 릴리즈 / 사용자 영향 최소화 / 롤백 즉시성 확보
항목내용
배포 절차빌드 → 테스트 → 승인 → 배포 → 검증
체크리스트env, 버전, API, 로그
검증 기준응답 200 / 로딩 2s / Lighthouse ≥ 90
롤백스크립트 + 캐시 무효화

1. 배포 절차

flowchart LR A[빌드 완료] --> B[테스트 통과] B --> C[릴리즈 브랜치 생성] C --> D[QA 승인] D --> E[배포 스크립트 실행] E --> F[모니터링 및 검증]
단계설명담당
빌드npm run build 실행FE
테스트CI 자동 수행QA
승인PO / Planner 승인PO
배포ArgoCD / JenkinsSE
검증Lighthouse, E2E 확인FE/QA

2. 배포 전 체크리스트

항목기준
.env 환경변수 검증누락/오타 없음
빌드 로그에러 0건
API 엔드포인트STAGE/PROD 정확히 지정
버전 태그SemVer 형식 (vX.Y.Z)
소스맵외부 노출 차단 설정

3. 배포 후 검증

검증 항목기준
API 정상 응답200 OK
주요 UI 렌더링로딩 < 2s
에러 로그콘솔 0건
Lighthouse 점수≥ 90

4. 롤백 절차

  • 배포 실패 시 previous-deploy.sh 스크립트 자동 실행
  • CDN 캐시 강제 무효화
  • 버전 태그 롤백 (rollback:vX.Y.Z)