피드로 돌아가기
Dev.toDevOps
원문 읽기
Cloudflare Pages 배포 후 런타임 실패 방지를 위한 3단계 검증 파이프라인 구축
Three post-deploy checks I run after every Cloudflare Pages build
AI 요약
Context
Astro 5 SSG 기반의 정적 사이트를 Cloudflare Pages로 배포하는 구조에서 production 환경 전용 버그 발생. 특히 _redirects 설정 오류로 인한 Sitemap 접근 불가 및 배포 지연으로 인한 IndexNow 제출 실패 등 런타임 가용성 검증의 필요성 대두.
Technical Solution
- Curl 명령어를 활용한 Sitemap HTTP 200 상태 코드 및 최소 URL 임계치(1,000개 이상) 검증을 통한 ETL 파이프라인 무결성 확인
- Redirect 추적을 배제한 HTTP 상태 체크로 _redirects 설정 오류 및 크롤러 접근 차단 리스크 제거
- Cloudflare Pages의 배포 지연 시간을 고려하여 GitHub Actions 내부가 아닌 별도의 workflow_dispatch 트리거로 IndexNow URL 제출 로직 분리
- IndexNow API 키 검증 파일(/.txt)의 배포 상태 확인을 통한 검색 엔진 인덱싱 지연 최소화
- Lighthouse CI Action을 이용한 주간 단위 성능 모니터링으로 Tailwind v4 및 광고 컴포넌트에 의한 Layout Paint 회귀 분석
- Runtime DB 쿼리가 없는 SSG 특성을 반영하여 API 가용성 체크 대신 정적 자산의 도달 가능성에 집중한 검증 범위 최적화
실천 포인트
1. 배포 자동화 시 Redirect 설정 오류를 잡기 위해 Redirect를 따르지 않는 HTTP 상태 체크 단계 추가
2. CDN 배포 완료 시점과 실제 URL 활성화 시점의 간극을 고려하여 외부 API 제출 스크립트의 실행 타이밍 설계
3. 모든 지표를 배포 차단 게이트로 설정하기보다, 서비스 단계(Pre-revenue 등)에 맞는 모니터링-차단 기준의 차등 적용