피드로 돌아가기
Dev.toDevOps
원문 읽기
SSG 배포 후 정적 자산 무결성과 IndexNow 연동을 검증하는 3단계 체크리스트
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Cloudflare Pages와 Astro 5 SSG 기반의 정적 사이트 운영 중 배포 지연 및 잘못된 _redirects 설정으로 인한 사이트맵 접근 불가 문제 발생. 전체 E2E 테스트 도입 대신 실제 발생한 Failure Mode에 최적화된 경량 검증 프로세스의 필요성 대두.
Technical Solution
- curl 명령어를 통한 sitemap-index.xml의 200 OK 상태 확인으로 Redirect 루프 및 경로 차단 여부 조기 식별
- sitemap-0.xml 내 최소 URL 수(예: 1,000개) 임계값 설정을 통한 ETL 데이터 파이프라인의 Silent Failure 탐지
- 배포 완료 후 별도의 workflow_dispatch 트리거를 활용한 IndexNow API 연동으로 실제 Live URL의 검색 엔진 색인 최적화
- Lighthouse CI를 Cron 스케줄(주 1회)로 설정하여 Performance 80 미만 및 CLS 0.1 초과 등 레이아웃 시프트 및 성능 회귀 모니터링
- 정적 CDN 배포 특성을 고려하여 Runtime API 및 Uptime 체크를 배제하고 배포 결과물(HTML/CSS/JSON)의 무결성에 집중한 검증 설계
실천 포인트
1. Redirect 설정 변경 후 브라우저 테스트 외에 curl -I 등을 통해 실제 HTTP 상태 코드 확인
2. 데이터 기반 정적 페이지 생성 시 결과물 내 레코드 최소 개수를 검증하여 파이프라인 오류 탐지
3. 인덱싱 최적화 도구 사용 시 배포 완료 시점과 Live URL 반영 시점의 시차를 고려한 트리거 설계
4. 성능 지표를 배포 차단 게이트가 아닌 추세 모니터링 도구로 활용하여 배포 속도 유지