피드로 돌아가기
Dev.toDevOps
원문 읽기
Cloudflare Pages SSG 배포 후 런타임 무결성 검증 자동화
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Astro 5 SSG 기반의 정적 사이트 배포 시 _redirects 설정 오류로 인한 Sitemap 접근 불가 및 배포 지연에 따른 데이터 불일치 문제 발생. 전체 E2E 테스트 도입 대신 실제 장애 사례 기반의 경량 포스트 배포 체크 프로세스 필요성 대두.
Technical Solution
- Curl 명령어를 통한 sitemap-index.xml의 HTTP 200 상태 코드 및 리다이렉트 미발생 여부 검증으로 크롤러 접근성 확보
- 특정 도메인의 sitemap-0.xml 내 URL 개수를 임계치(예: 1,000개)와 비교하여 ETL 파이프라인의 Silent Failure 탐지
- Cloudflare Pages의 빌드 지연 시간을 고려하여 GitHub Actions 워크플로우 외부에서 workflow_dispatch 트리거를 통한 IndexNow API의 라이브 URL 제출
- Lighthouse-CI를 활용한 주간 단위의 Performance/CLS/Accessibility 회귀 테스트 수행 및 결과 Diff 분석 구조 설계
- SSG 특성상 런타임 API 호출이 없으므로 Uptime 모니터링과 API 가용성 체크를 배제한 효율적 검증 범위 설정
실천 포인트
- 리다이렉트 룰 적용 후 Curl -o /dev/null -w "%{http_code}"를 통해 실제 HTTP 응답 코드 검증 - SSG 환경에서는 빌드 완료 후 실제 CDN 반영 시점을 고려한 비동기식 외부 인덱싱 요청 설계 - 정적 사이트의 성능 저하는 CSS 프레임워크 설정 변경이나 광고 컴포넌트로 인한 Layout Shift 가능성을 우선 검토 - 비즈니스 단계에 따라 Lighthouse 점수를 배포 차단 게이트가 아닌 추세 모니터링 지표로 활용