개요

0) 목적

배포 실패를 줄이고, 재현 가능한 릴리스 절차를 유지하기 위한 체크리스트입니다.

1) 릴리스 전 점검

• [ ] 변경사항 범위와 영향 문서화
• [ ] 문서 링크 깨짐 여부 점검
• [ ] 오탈자/형식(헤더 구조) 점검
• [ ] 민감정보 포함 여부 점검

2) 로컬 검증

npm install
npm run docs:check
npm run docs:build
npm run docs:preview

• [ ] build 에러 없음
• [ ] 주요 페이지 렌더링 정상
• [ ] 모바일 뷰에서 메뉴/본문 가독성 확인

3) GitHub Actions 배포 (자동 + 수동)

1. main 머지 시 자동 배포 실행 여부 확인
2. 필요 시 GitHub 저장소 Actions 탭에서 Deploy VitePress to Cloudflare Pages 수동 실행
3. 로그에서 build/deploy 단계 성공 확인

• [ ] Actions 실행 성공
• [ ] Cloudflare Pages 배포 URL 접속 확인

4) 배포 후 점검

• [ ] 홈/가이드/핵심 개념 페이지 접근 확인
• [ ] 내부 링크/버튼 동작 확인
• [ ] 이전 버전 캐시 영향 여부 확인
• [ ] 필요한 경우 변경 공지 작성

5) 롤백 계획

• [ ] 최근 안정 커밋 태그/해시 기록
• [ ] 긴급 시 되돌릴 절차를 팀 내 공유
• [ ] 장애 대응 담당자/연락채널 명시