피드로 돌아가기
Dev.toDevOps
원문 읽기
Cloudflare Pages SSG 배포 후 런타임 가시성 확보를 위한 3단계 검증 파이프라인
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Cloudflare Pages와 Astro 5 SSG 기반의 정적 사이트 운영 중 _redirects 설정 오류로 인한 Sitemap 접근 불가 및 배포 지연에 따른 데이터 불일치 발생. 단순 E2E 테스트 대신 실제 발생한 Failure Mode에 집중한 경량 검증 프로세스의 필요성 대두.
Technical Solution
- Curl의
-o /dev/null -w "%{http_code}"옵션을 활용하여 리다이렉트를 배제한 순수 200 OK 응답 검증으로 _redirects 설정 오류 조기 발견 - Sitemap-0.xml 내 URL 개수 임계치(예: 1,000개) 설정을 통한 ETL 데이터 파이프라인의 Silent Failure 감지
- 배포 완료 후
workflow_dispatch트리거를 통해 Live URL 기반의 IndexNow Batch Submission을 수행함으로써 배포 랙으로 인한 인덱싱 지연 방지 - Lighthouse CI Action을 활용한 주간 성능 모니터링 및
temporaryPublicStorage기반의 Regression Diff 분석 구조 설계 - SSG 특성을 고려하여 Runtime API 체크를 배제하고 HTML/CSS/JSON으로 구성된 정적 자산의 가시성 확보에 집중
실천 포인트
1. Redirect 설정 시 브라우저 테스트 외에 Curl 등을 이용한 Raw HTTP Status Code 검증 절차 추가
2. 데이터 파이프라인 결과물이 반영된 정적 파일의 최소 레코드 수(Threshold) 검증 로직 도입
3. CDN 배포 환경에서 Build 완료 시점과 실제 Edge 반영 시점의 시차를 고려한 외부 API 알림 시퀀스 설계
4. 성능 지표를 배포 차단 게이트(Gate)가 아닌 추세 모니터링(Trend Monitor)으로 분리하여 운영 효율성 확보