Cloudflare Pages 배포 후 런타임 오류 최소화를 위한 3단계 검증 파이프라인 구축

Three post-deploy checks I run after every Cloudflare Pages build

MORINAGA2026년 6월 6일4분intermediate

AI 요약

Context

Cloudflare Pages와 Astro 5 SSG 기반의 정적 사이트 운영 중 _redirects 설정 오류 및 배포 지연으로 인한 Race Condition 발생. 단순 빌드 성공만으로는 런타임의 실제 도달 가능성과 검색 엔진 색인 최적화를 보장할 수 없는 한계 직면.

Technical Solution

curl -o /dev/null -w "%{http_code}"를 활용해 Redirect를 제외한 순수 200 OK 응답을 검증함으로써 잘못된 리다이렉션 규칙 식별
sitemap-0.xml의 URL 개수를 임계치(예: 1,000개)와 비교하여 ETL 파이프라인의 Silent Failure를 탐지하는 데이터 무결성 검사 수행
Cloudflare Pages의 배포 지연 시간을 고려하여 CI/CD 인라인 방식이 아닌 별도의 workflow_dispatch 트리거를 통한 IndexNow API 배치 제출로 실시간 URL 반영 보장
리소스 낭비를 방지하기 위해 Lighthouse CI를 매 배포가 아닌 주간 단위 Cron 스케줄로 운영하며 성능 저하 추이 모니터링
SSG 특성을 반영하여 런타임 API 체크 대신 빌드 타임의 Turso DB 쿼리 결과물이 포함된 정적 파일의 유효성 검증에 집중

실천 포인트

- 리다이렉션 규칙 변경 후에는 Browser가 아닌 Curl 등을 통해 실제 HTTP 상태 코드를 직접 검증할 것 - 데이터 파이프라인 기반 사이트는 단순 페이지 접속 여부를 넘어 최소 기대 콘텐츠 수량을 확인하는 Threshold 검증 도입 - CDN 배포 플랫폼의 Propagating 시간을 고려하여 외부 API 알림(Indexing 등)은 배포 완료 후 별도 단계로 분리

태그

#SSG #Astro SSG #Lighthouse CI #IndexNow #Cloudflare Pages

원문 읽기