Cloudflare Pages 빌드 후 수행하는 3가지 배포 후 체크 사항

프로덕션 문제를 해결하는 데 2주를 보냈습니다.

한 가지 오류는 사이트맵 리다이렉트 규칙과 관련이 있었습니다. 이 규칙이 제 사이트맵 파일을 차단했습니다. 또 다른 오류는 이미지 업로드 지연 문제였습니다.

저는 전체 엔드 투 엔드(end-to-end) 테스트 스위트를 사용하지 않습니다. 대신 세 가지 특정 체크를 사용합니다. 이 체크들은 제 사이트가 실패하는 정확한 지점들을 겨냥합니다.

저는 이 체크들을 세 개의 Astro 5 SSG 사이트인 aiappdex.com, findindiegame.com, ossfind.com에서 실행합니다.

  1. 사이트맵 검증

sitemap-index.xml이 200 상태 코드를 반환하는지 확인합니다. 리다이렉트를 따라가지 않습니다. 잘못된 리다이렉트 규칙은 브라우저에서는 오류를 숨기면서 크롤러에게는 오류를 노출할 수 있기 때문에 이 과정이 중요합니다.

또한 sitemap-0.xml도 확인합니다. 최소한의 URL 개수가 유지되고 있는지 확인합니다. URL 개수가 줄어든다면 데이터 파이프라인에 문제가 생겼을 가능성이 높습니다.

  1. IndexNow 제출

사이트맵 확인 후, IndexNow에 URL을 제출하는 스크립트를 실행합니다. 이를 통해 Bing, Yandex, Naver, Seznam에 새로운 콘텐츠가 있음을 알립니다.

IndexNow에서 403 오류가 발생하면 키 검증 파일이 누락되었거나 리다이렉트 규칙이 경로를 끊고 있는 것입니다. 이를 즉시 확인하면 인덱싱 지연을 방지할 수 있습니다.

배포 후 이 작업을 수동으로 실행합니다. 이를 통해 배포 프로세스 중인 URL이 아닌, 실제 라이브 URL을 제출할 수 있습니다.

  1. Lighthouse 트렌드 모니터링

매주 월요일마다 정기적으로 Lighthouse 체크를 실행합니다. 사이트당 홈페이지 하나와 하위 페이지(deep page) 하나를 확인합니다.

다음 사항들을 확인합니다:

  • 80 미만의 성능 점수
  • 0.1을 초과하는 CLS
  • 접근성 저하(Accessibility regressions)

이 점수들이 떨어진다고 해서 배포를 차단하지는 않습니다. 대신 이 점수들을 트렌드 모니터링 용도로 사용합니다. 점수가 하락하면 CSS나 컴포넌트의 레이아웃 변경을 의미할 수 있습니다.

왜 이 세 가지인가요?

Cloudflare를 신뢰하기 때문에 업타임 모니터링은 사용하지 않습니다. 사이트가 정적(static)이기 때문에 API 체크도 사용하지 않습니다. 정적 CDN 배포의 경우, 이 세 가지 체크가 실제 리스크를 충분히 커버합니다.

출처: https://dev.to/morinaga/three-post-deploy-checks-i-run-after-every-cloudflare-pages-build-f12