피드로 돌아가기
Dev.toDevOps
원문 읽기
Cloudflare Pages 배포 후 런타임 가시성 확보를 위한 3단계 검증 파이프라인
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Astro 5 기반의 SSG 아키텍처에서 Cloudflare Pages 배포 시 _redirects 설정 오류와 배포 지연으로 인한 데이터 불일치 발생. 전체 E2E 테스트 도입 대신 실제 장애 패턴에 기반한 경량화된 Post-deploy 검증 체계가 필요했던 상황.
Technical Solution
- curl의 -o /dev/null -w "%{http_code}" 옵션을 활용해 Redirect를 무시한 순수 200 OK 응답 여부를 확인하는 Sitemap Reachability 체크 구현
- ETL 파이프라인의 무음 실패(Silent Failure) 감지를 위해 sitemap-0.xml 내 최소 URL 임계값(aiappdex.com 기준 1,000개) 검증 로직 적용
- Cloudflare Pages의 배포 지연(2-3분)과 IndexNow의 실시간 URL 요구사항 간의 간극을 해결하기 위해 workflow_dispatch 기반의 비동기 배치 제출 스크립트 운영
- 런타임 변경이 없는 정적 사이트 특성을 고려하여 Lighthouse CI를 매 배포가 아닌 주 1회 Cron 스케줄로 실행함으로써 리소스 낭비 방지
- Tailwind v4 설정 변경으로 인한 Layout Paint 변동을 감지하기 위해 성능 점수(80점 미만) 및 CLS(0.1 초과) 모니터링 체계 구축
실천 포인트
- CDN 리다이렉트 설정이 브라우저에서는 정상이나 크롤러에게는 장애가 될 수 있으므로, 리다이렉트를 따르지 않는 HTTP 상태 코드 검증 수행 - 배포 완료 시점과 실제 엣지 노드 전파 시점의 시차를 고려하여 외부 API(IndexNow 등) 연동 시 분리된 트리거 구조 설계 - 정적 사이트의 경우 무거운 E2E 테스트보다 핵심 파일(Sitemap)의 크기 및 상태를 체크하는 가벼운 헬스체크 도입 검토 - 비즈니스 단계에 따라 Lighthouse 점수를 배포 차단(Gate) 지표가 아닌 추세 분석(Trend Monitor) 지표로 활용하여 배포 속도 유지