피드로 돌아가기
Dev.toDevOps
원문 읽기
Cloudflare Pages 배포 후 런타임 오류 방지를 위한 3단계 검증 파이프라인 구축
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Cloudflare Pages와 Astro 5 SSG 기반의 정적 사이트 운영 중 _redirects 규칙 설정 오류 및 배포 지연으로 인한 데이터 불일치 발생. 단순 빌드 성공 여부가 아닌, 실제 프로덕션 환경의 도달 가능성과 인덱싱 상태를 검증하는 런타임 체크 프로세스의 부재를 확인.
Technical Solution
- curl의 -o /dev/null -w "%{http_code}" 옵션을 활용한 Sitemap Reachability 검증으로 리다이렉션 루프 및 404 오류 조기 발견
- 최소 URL 임계치(aiappdex.com 기준 1,000개) 설정을 통한 ETL 데이터 파이프라인의 Silent Failure 탐지 체계 구축
- Cloudflare Pages의 배포 지연 시간을 고려하여 GitHub Actions 내 inline 실행이 아닌 별도의 workflow_dispatch 트리거로 IndexNow 배치 제출 분리
- IndexNow API를 통한 403 응답 모니터링으로 Key Verification 파일 배포 누락 및 경로 변조 여부 실시간 확인
- Lighthouse CI Action 기반의 주간 Cron Job 설정을 통해 Performance 80 미만 및 CLS 0.1 초과 등 레이아웃 시프트 추세 관리
실천 포인트
- curl을 이용해 리다이렉션을 제외한 순수 HTTP 상태 코드를 확인하여 _redirects 설정 오류를 검증할 것 - 데이터 파이프라인의 무결성 확인을 위해 정적 파일 내 최소 예상 레코드 수를 정의하고 검증 단계에 포함할 것 - CDN 배포 완료 시점과 외부 API 동기화 시점의 간극을 고려하여 비동기적/분리된 배포 후 검증 워크플로우를 설계할 것 - 성능 지표는 배포 차단(Gate) 목적이 아닌 추세 모니터링(Trend Monitor) 용도로 분리하여 운영 효율성을 확보할 것