Cloudflare Pages 배포 후 런타임 가용성 확보를 위한 3단계 검증 파이프라인

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

MORINAGA2026년 5월 20일4분intermediate

AI 요약

Context

Cloudflare Pages와 Astro 5 SSG 기반의 정적 사이트 운영 중 _redirects 설정 오류 및 배포 지연으로 인한 데이터 누락 발생. 단순 E2E 테스트 대신 실제 장애 패턴에 기반한 경량 검증 프로세스의 필요성 대두.

curl 명령어를 활용한 sitemap-index.xml의 HTTP 200 응답 확인으로 Redirect Rule 오설정으로 인한 크롤러 차단 방지
sitemap-0.xml 내 최소 URL 임계값(예: aiappdex.com 1,000개) 검증을 통한 ETL 파이프라인의 무결성 확인
IndexNow API를 이용한 실시간 URL 제출로 배포 직후 검색 엔진 인덱싱 지연 시간 최소화
배포 완료 후 별도 workflow_dispatch 트리거를 통해 실제 Live URL 기반의 API 제출 로직 분리
Lighthouse CI Action을 활용한 주간 정기 스팟 체크로 CLS 0.1 이하 및 Performance 80점 이상의 레이아웃 안정성 모니터링
SSG 특성에 따라 런타임 API 체크를 배제하고 정적 자산의 가용성 및 성능 지표에 집중한 검증 범위 설정

실천 포인트

1. Redirect 설정 시 브라우저의 자동 리다이렉션에 속지 않도록 curl -o /dev/null -w "%{http_code}"로 실제 상태 코드 검증

2. SSG 빌드 시 데이터 누락 여부를 확인하기 위해 Sitemap 내 URL 개수 임계값 검증 로직 추가

3. 배포 파이프라인 내에 IndexNow와 같은 외부 인덱싱 API 연동 시, 배포 완료 후 Live URL이 확정된 시점에 실행하도록 트리거 분리

4. 성능 지표(Lighthouse)를 배포 차단 게이트가 아닌 추세 모니터링 용도로 활용하여 배포 속도 유지

태그