피드로 돌아가기
Dev.toDevOps
원문 읽기
SSG 배포 후 런타임 무결성 확보를 위한 3단계 검증 파이프라인 구축
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Cloudflare Pages와 Astro 5 SSG 기반의 정적 사이트 운영 중 _redirects 설정 오류 및 배포 지연으로 인한 데이터 유실 발생. 단순 빌드 성공 여부가 아닌 실제 Edge 네트워크상의 파일 도달 가능성과 인덱싱 상태를 검증해야 하는 필요성 대두.
Technical Solution
- curl의 -o /dev/null -w %{http_code} 옵션을 통한 Redirect 제외 순수 200 OK 응답 검증으로 sitemap-index.xml 도달성 확보
- sitemap-0.xml 내 최소 URL 임계값(예: 1,000개) 설정을 통한 ETL 파이프라인의 Silent Failure 감지 체계 구축
- 배포 완료 후 별도의 workflow_dispatch 트리거를 통한 IndexNow API 호출로 실시간 라이브 URL 기반의 검색 엔진 인덱싱 최적화
- Lighthouse CI를 활용한 주간 단위의 성능 추이 모니터링으로 Tailwind v4 설정 변경에 따른 레이아웃 시프트 및 Paint 성능 회귀 방지
- SSG 특성에 맞춰 런타임 API 체크를 배제하고 정적 파일의 유효성과 SEO 가용성에 집중한 최소 효율적 검증 범위 설정
실천 포인트
- 배포 후 Redirect 루프나 잘못된 규칙 설정을 잡기 위해 Redirect를 따르지 않는 HTTP 상태 코드 체크 스크립트 도입 - 데이터 파이프라인 결과물이 포함된 정적 파일의 최소 레코드 수를 정의하여 무결성 검증 - 인덱싱 API 호출 시 배포 완료 시점과 실제 Edge 전파 시점의 시차를 고려한 별도 트리거 설계 - 모든 성능 지표를 배포 차단 게이트로 설정하기보다 비즈니스 단계에 맞는 추세 모니터링 지표로 활용