피드로 돌아가기
Dev.toDevOps
원문 읽기
SSG 배포 후 런타임 가용성과 인덱싱 효율을 보장하는 3단계 검증 체계 구축
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Cloudflare Pages와 Astro 5 SSG 기반의 정적 사이트 운영 중, _redirects 설정 오류로 인한 sitemap 접근 불가 및 배포 지연으로 인한 데이터 정합성 문제 발생. 전체 E2E 테스트 도입 대신 실제 발생한 실패 모드(Failure Mode)에 집중한 고효율 검증 프로세스 필요성 대두.
Technical Solution
- Curl의
-o /dev/null -w "%{http_code}"옵션을 활용해 Redirect를 무시하고 sitemap-index.xml의 순수 HTTP 200 응답 여부 검증 - sitemap-0.xml 내 URL 개수가 임계치(예: aiappdex.com 1,000개) 미만일 경우 ETL 파이프라인의 Silent Failure로 판단하는 정량적 검증 로직 적용
- Cloudflare Pages의 빌드-배포 시차(2~3분)를 고려하여 IndexNow 제출을 GitHub Actions 인라인 프로세스가 아닌 별도의
workflow_dispatch트리거로 분리하여 Live URL 기반 제출 보장 - Lighthouse CI를 활용해 매 배포가 아닌 주 1회 Cron 기반 스폿 체크를 수행함으로써 정적 사이트 특성에 맞는 리소스 효율적 성능 모니터링 구현
- Turso DB를 빌드 타임에만 쿼리하는 SSG 구조를 활용하여 런타임 API 가용성 체크를 배제하고 CDN 전송 계층의 가용성에 집중한 설계
실천 포인트
- HTTP 응답 코드 검증 시 Redirect 추적 여부가 비즈니스 로직(SEO 등)에 미치는 영향을 분석하고 적절한 curl 옵션 선택 - 데이터 파이프라인의 무결성 확인을 위해 단순 성공/실패가 아닌 결과물의 정량적 임계치(Threshold) 검증 단계 추가 - CDN 배포 시스템의 전파 지연(Propagation Delay)을 고려하여 외부 API 알림 및 인덱싱 제출 시점을 분리 설계 - 서비스의 트래픽 규모와 변경 빈도에 따라 모니터링 도구(Lighthouse 등)의 실행 주기를 차등 설정하여 CI/CD 비용 최적화