피드로 돌아가기
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 설정 오류로 인해 브라우저에서는 정상 작동하나 검색 엔진 크롤러는 접근하지 못하는 가시성 불일치 지점 식별.
Technical Solution
- curl의 -o /dev/null -w "%{http_code}" 옵션을 활용해 Redirect를 제외한 순수 200 OK 응답만 확인하는 Sitemap 도달 가능성 검증 체계 구축
- ETL 파이프라인의 무음 실패(Silent Failure) 감지를 위해 sitemap-0.xml 내 최소 URL 임계치(예: aiappdex.com 기준 1,000개) 검사 로직 도입
- Cloudflare Pages의 배포 지연(Deploy Lag) 및 라이브 URL 반영 시점을 고려하여 GitHub Actions 내부가 아닌 별도의 workflow_dispatch 트리거로 IndexNow API 제출 프로세스 분리
- 런타임 변경 사항이 없는 SSG 특성을 반영하여 리소스 낭비를 방지하고자 Lighthouse CI를 매 배포가 아닌 주 1회 Cron 기반의 스팟 체크 방식으로 설계
- Tailwind v4 설정 및 광고 컴포넌트 변경으로 인한 레이아웃 시프트(CLS) 및 성능 저하를 모니터링하는 회귀 분석 구조 적용
실천 포인트
- 정적 사이트 배포 시 브라우저 캐시/리다이렉트에 속지 않도록 HTTP 상태 코드를 직접 확인하는 헬스체크 스크립트 작성 - 데이터 파이프라인의 무결성을 검증하기 위해 결과물 파일의 최소 데이터 수량(Threshold)을 확인하는 검증 단계 추가 - 인덱싱 API 제출 시 배포 완료 시점과 실제 CDN 전파 시점의 간극을 고려한 비동기 트리거 설계 검토 - 서비스 규모와 트래픽에 따라 CI/CD 게이트(Gate)와 트렌드 모니터링(Monitor)의 기준을 차등 적용하여 배포 속도 유지