피드로 돌아가기
Dev.toDevOps
원문 읽기
Sitemap 검증 및 IndexNow 자동화로 SSG 배포 실패 표면 제거
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Cloudflare Pages와 Astro 5 SSG 기반의 정적 사이트 운영 중 _redirects 설정 오류 및 배포 지연으로 인한 프로덕션 장애 발생. E2E 테스트 전체 도입 대신 실제 발생한 Failure Mode에 집중한 고효율 Post-deploy 체크 프로세스 필요성 대두.
Technical Solution
- Curl의 -o /dev/null -w "% {http_code}" 옵션을 통한 Redirect 제외 순수 HTTP 200 응답 검증으로 Sitemap 도달 가능성 확보
- Sitemap 내 URL 개수 임계값(예: 1,000개) 설정을 통한 ETL 데이터 파이프라인의 Silent Failure 조기 감지 구조 설계
- Cloudflare Pages의 배포 지연 시간을 고려하여 GitHub Actions 메인 워크플로우와 분리된 workflow_dispatch 트리거 기반 IndexNow 제출 로직 구현
- Lighthouse-CI를 활용한 Performance(80 미만) 및 CLS(0.1 초과) 모니터링을 통한 Tailwind v4 설정 및 레이아웃 회귀 분석
- 런타임 API 쿼리가 없는 SSG 특성을 반영하여 Uptime 및 API 가용성 체크를 제외한 최소 비용의 Failure Surface 최적화
실천 포인트
- Redirect를 무시하는 HTTP 상태 코드 체크로 실제 리소스 도달 가능성 검증 - 데이터 기반 사이트의 경우 Sitemap URL 수량의 최소 임계값을 설정하여 파이프라인 무결성 확인 - CDN 배포 지연(Propagation Lag)이 있는 환경에서는 배포 완료 후 별도 트리거로 외부 API 알림 전송 - 트래픽이 낮은 초기 서비스는 Lighthouse 점수를 배포 차단 게이트가 아닌 트렌드 모니터링 지표로 활용