Cloudflare Pages 배포 후 런타임 무결성 검증을 통한 사이트맵 및 인덱싱 오류 차단

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

MORINAGA2026년 6월 4일4분intermediate

AI 요약

Context

Astro 5 SSG 기반의 정적 사이트 배포 환경에서 리다이렉트 설정 오류 및 배포 지연으로 인한 데이터 누락 발생. 전체 E2E 테스트 도입 대신 실제 장애 사례 기반의 경량화된 Post-deploy 체크 프로세스 필요성 대두.

Technical Solution

curl의 -o /dev/null 및 -w %{http_code} 옵션을 활용해 리다이렉트를 무시한 sitemap-index.xml의 200 OK 응답 여부 검증
sitemap-0.xml 내 URL 개수를 임계치(예: 1,000개)와 비교하여 ETL 파이프라인의 무음 실패(Silent Failure) 탐지
Cloudflare Pages의 배포 지연 시간을 고려하여 GitHub Actions 내 인라인 실행이 아닌 별도의 workflow_dispatch 트리거로 IndexNow API 호출
정적 페이지 특성을 반영하여 매 배포가 아닌 주간 단위 Cron 기반의 Lighthouse CI 스팟 체크 수행으로 리소스 낭비 방지
runtime-query가 없는 SSG 구조를 반영하여 Turso DB API 및 Uptime 모니터링을 제외한 최적화된 검증 범위 설정

실천 포인트

- 리다이렉트 규칙이 실제 크롤러의 접근을 차단하는지 확인하기 위해 Redirect-follow 옵션을 끈 상태의 HTTP 상태 코드 검증 - SSG 환경에서 데이터 소스-빌드-배포로 이어지는 파이프라인의 무결성을 확인하기 위해 최종 결과물의 정량적 수치(URL count 등) 검증 - 인프라 전파 속도(Propagation lag)를 고려하여 배포 완료 시점과 외부 API 통보 시점의 분리 설계

태그

#SSG #Post-deployment Check #Lighthouse CI #IndexNow #Cloudflare Pages

원문 읽기