피드로 돌아가기
Dev.toDevOps
원문 읽기
Cloudflare Pages SSG 환경의 배포 후 검증 자동화로 런타임 장애 최소화
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Astro 5 SSG 기반의 정적 사이트 배포 후, 브라우저에서는 정상이나 크롤러에게는 차단되는 _redirects 설정 오류 및 데이터 파이프라인 장애를 사전에 감지하지 못한 한계 발생. 전체 E2E 테스트 대신 실제 발생 가능한 Failure Mode에 집중한 경량 검증 프로세스 필요성 대두.
Technical Solution
- curl -o /dev/null -w "%{http_code}"를 통한 Sitemap의 200 OK 상태 확인으로 리다이렉트 루프 및 경로 차단 즉각 식별
- sitemap-0.xml 내 URL 개수 임계치(예: 1,000개) 검증을 통한 ETL 데이터 파이프라인의 Silent Failure 감지
- 배포 완료 후 별도의 workflow_dispatch 트리거를 통해 IndexNow API에 실시간 URL을 POST 하여 인덱싱 지연 방지
- lighthouse-ci-action 기반의 주기적(Weekly) 스팟 체크를 통해 Tailwind v4 설정 변경으로 인한 레이아웃 시프트(CLS) 및 성능 회귀 모니터링
- SSG 특성을 고려하여 런타임 API 체크를 배제하고 빌드 타임에 결정되는 정적 자산의 가용성 검증에 집중한 설계
실천 포인트
- 리다이렉트 추적을 하지 않는 HTTP 상태 코드 검증으로 실제 크롤러 관점의 접근성 확인 - 정적 페이지의 핵심 콘텐츠 수량을 Threshold 기반으로 체크하여 데이터 파이프라인 무결성 검증 - CI/CD 파이프라인 내에서 배포 완료 시점과 외부 API 전송 시점의 시차를 고려한 분리된 워크플로우 설계 - 비즈니스 중요도에 따라 Lighthouse 점수를 배포 차단 게이트(Gate)가 아닌 추세 모니터링(Trend) 용도로 활용