피드로 돌아가기
Dev.toDevOps
원문 읽기
SSG 배포 후 런타임 에러 방지를 위한 3단계 검증 파이프라인 구축
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Cloudflare Pages와 Astro 5 SSG 기반의 정적 사이트 운영 중 _redirects 설정 오류로 인한 sitemap 접근 불가 및 배포 지연으로 인한 Race Condition 발생. 전체 E2E 테스트 도입 대신 실제 장애가 발생한 지점 위주의 고효율 Post-deploy 검증 체계 필요성 대두.
Technical Solution
- curl의 -o /dev/null -w "%{http_code}" 옵션을 통해 Redirect를 무시한 순수 HTTP 상태 코드 검증으로 sitemap-index.xml의 실제 도달 가능성 확인
- 데이터 파이프라인의 Silent Failure 감지를 위해 sitemap-0.xml 내 최소 URL 임계값(1,000개) 검증 로직 적용
- Cloudflare Pages의 배포 지연 시간을 고려하여 GitHub Actions 인라인 단계가 아닌 별도의 workflow_dispatch 트리거를 통한 IndexNow 배치 제출로 Live URL 정합성 확보
- Lighthouse CI Action을 활용한 매주 월요일 04:30 UTC 정기 성능 모니터링 체계 구축을 통한 Layout Paint 회귀 분석
- 정적 자산의 특성을 반영하여 Runtime API 체크 대신 Build-time 데이터 무결성과 CDN 전파 후의 접근성 검증에 집중한 설계
실천 포인트
- CDN 리다이렉션 규칙 설정 시 브라우저의 자동 리다이렉트 기능에 의존하지 말고 curl 등으로 Raw Response 검증 - SSG 배포 시 Build-time에 생성된 파일의 수량(URL count)을 체크하여 ETL 파이프라인의 무결성 확인 - 외부 API(IndexNow 등) 연동 시 인프라 배포 완료 시점과 API 호출 시점의 시차를 고려한 비동기 워크플로우 설계 - 성능 지표를 배포 차단용 Gate가 아닌 추세 모니터링용 Trend Monitor로 활용하여 배포 속도 유지