피드로 돌아가기
Dev.toDevOps
원문 읽기
Sitemap 검증 및 IndexNow 자동화 통한 SSG 배포 신뢰성 확보
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Cloudflare Pages와 Astro 5 SSG 기반의 정적 사이트 운영 중 _redirects 설정 오류로 인한 Sitemap 접근 불가 현상 발생. 배포 직후 발생하는 런타임 오류와 인덱싱 지연을 방지하기 위해 단순 E2E 테스트가 아닌 실제 장애 기반의 포스트 배포 체크 프로세스 필요성 대두.
Technical Solution
- curl 명령어를 활용한 sitemap-index.xml의 HTTP 200 상태 코드 및 리다이렉션 미발생 여부 검증
- 특정 임계값(예: aiappdex.com 기준 1,000개) 이상의 URL 포함 여부를 통한 ETL 파이프라인 무결성 확인
- 배포 지연 시간을 고려하여 GitHub Actions 내부가 아닌 별도의 workflow_dispatch 트리거로 IndexNow API를 통한 실시간 URL 제출
- IndexNow 키 검증 파일(/.txt)의 도달 가능성을 확인하여 검색 엔진 인덱싱 지연 방지
- Lighthouse CI를 활용한 주간 단위 성능 및 Layout Shift(CLS) 트렌드 모니터링 체계 구축
- SSG 특성을 고려하여 런타임 API 체크를 배제하고 정적 파일의 도달 가능성에 집중한 최소 비용 검증 설계
실천 포인트
- 정적 사이트 배포 시 _redirects 룰이 Sitemap 접근을 방해하는지 curl -I 등으로 확인하십시오. - 외부 검색 엔진 API(IndexNow 등) 연동 시, CDN 캐시 및 배포 완료 시점을 고려해 비동기 워크플로우로 분리하십시오. - 모든 페이지 E2E 테스트 대신, 핵심 데이터(Sitemap URL 수 등)의 정량적 임계값 검증을 도입해 파이프라인 오류를 빠르게 감지하십시오. - 성능 지표는 배포 차단 게이트가 아닌, 트렌드 분석용 모니터링 지표로 활용하여 배포 속도를 유지하십시오.