피드로 돌아가기
Dev.toDevOps
원문 읽기
Cloudflare Pages 배포 후 런타임 장애 방지를 위한 3단계 정밀 검증 체계 구축
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Astro 5 SSG 기반의 정적 사이트 배포 환경에서 _redirects 설정 오류와 배포 지연으로 인한 Race Condition 발생. 기존 CI/CD 파이프라인만으로는 실 배포 환경의 Edge Case와 사이트맵 접근성 문제를 사전에 탐지하기 어려운 구조적 한계 존재.
Technical Solution
- curl 명령어를 통한 sitemap-index.xml의 HTTP 200 응답 및 리다이렉트 미추적 검증으로 잘못된 Rewrite 규칙 조기 발견
- 특정 도메인(aiappdex.com) 대상 최소 URL 임계치(1,000개) 설정 및 검증을 통한 ETL 데이터 파이프라인의 Silent Failure 탐지
- 배포 완료 후 Live URL 기반의 IndexNow API Batch Submission을 별도 workflow_dispatch로 분리하여 배포 지연에 따른 인덱싱 누락 방지
- Lighthouse CI Action을 활용한 주간 단위 Performance 및 CLS 모니터링으로 Tailwind v4 설정 변경에 따른 Layout Shift 추적
- SSG 특성에 맞춰 런타임 API 체크를 배제하고 CDN 배포 파일의 정합성과 검색 엔진 가시성 확보에 집중한 검증 설계
실천 포인트
- Edge Redirect 설정 시 브라우저의 자동 리다이렉션에 속지 않도록 curl -o /dev/null -w "%{http_code}"를 통한 순수 상태 코드 검증 - 배포 직후의 인덱싱 요청은 빌드 완료 시점과 실제 엣지 전파 시점의 시차를 고려하여 별도 트리거로 분리 - 정적 사이트의 경우 모든 배포에 E2E 테스트를 적용하기보다 핵심 리소스(Sitemap, Index page)의 가용성 체크로 효율성 극대화 - 성능 지표를 배포 차단(Gate) 수단이 아닌 추세 분석(Trend Monitor) 용도로 활용하여 릴리즈 속도 유지