피드로 돌아가기
Dev.toDevOps
원문 읽기
SSG 배포 후 런타임 오류 최소화를 위한 3단계 사후 검증 파이프라인 구축
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Cloudflare Pages 기반 Astro 5 SSG 환경에서 _redirects 설정 오류 및 배포 지연으로 인한 프로덕션 장애 경험. 전체 E2E 테스트 도입 대신 실제 장애 발생 지점에 집중한 경량 검증 프로세스의 필요성 대두.
Technical Solution
- Curl의 -o /dev/null -w "%{http_code}" 옵션을 활용하여 Redirect를 제외한 순수 HTTP 200 상태 코드 검증으로 Sitemap 도달 가능성 확인
- 특정 도메인의 Sitemap URL 개수 임계값(예: 1,000개) 설정을 통한 ETL 데이터 파이프라인의 정적 분석 및 무결성 검증
- Cloudflare Pages의 배포 지연(2-3분)을 고려하여 GitHub Actions 내 인라인 실행이 아닌 별도의 workflow_dispatch 트리거로 IndexNow API 연동
- 정적 사이트의 특성을 반영하여 매 배포가 아닌 주 단위 Cron Job 기반의 Lighthouse CI 수행을 통한 성능 및 Layout Paint 회귀 분석
- 런타임 쿼리가 없는 SSG 구조에 맞춰 API 및 Uptime 모니터링을 제외하고 실제 장애 표면(Failure Surface)인 정적 파일 접근성에 집중한 검증 범위 설계
실천 포인트
- Redirect 설정이 실제 크롤러 접근을 차단하는지 확인하기 위해 Redirect를 추적하지 않는 HTTP 상태 코드 검증 수행 - 데이터 파이프라인 오류 감지를 위해 생성된 정적 파일 내 최소 레코드 수(Threshold) 검증 로직 추가 - 인프라 배포 완료 시점과 외부 API(IndexNow 등)의 동기화 시차를 고려한 비동기 검증 워크플로우 설계 - 리소스 낭비를 방지하기 위해 변경 빈도가 낮은 정적 페이지는 전수 조사 대신 대표 URL 샘플링 기반의 스케줄링 검사 적용