검색
← 릴리스 노트

대규모 문서 사이트의 초고속 콘텐츠 갱신

Vercel · 기타 · 2026.05.01

Vercel에서 3만 개 문서 사이트의 캐시 무효화와 콘텐츠 갱신을 300ms 안팎으로 처리하는 사례를 소개합니다.

교안에 영향

문서 업데이트와 캐시 무효화 기준이 병합 이벤트와 태그 기반 방식으로 설명되어, 기존의 단순 페이지 단위 캐시 설명은 맞지 않을 수 있습니다.

요약

- GitBook은 하나의 Vercel 배포로 30,000개 문서 사이트와 월 1억 2천만 페이지뷰를 처리합니다. - use cache directive로 데이터 조회 함수 단위 캐시를 적용해 비용이 큰 API 호출을 중복 없이 재사용합니다. - merge 이벤트에 따라 태그 기반 무효화를 수행해 영향받는 콘텐츠만 다시 검증하고 나머지는 캐시를 유지합니다. - AI 크롤러와 자동화 트래픽 비중이 41%까지 늘면서 예측 불가능한 요청 패턴에도 빠른 응답을 유지합니다.

바뀐 것

개선 3

  • use cache directive를 사용해 전체 페이지 응답이 아니라 개별 데이터 조회 함수에 캐시를 적용합니다.
  • 병합 이벤트를 기준으로 태그 기반 무효화를 수행해 관련 콘텐츠만 다시 검증합니다.
  • 변경이 반영되면 업데이트된 콘텐츠가 전 세계에 300밀리초 이내로 보이도록 합니다.

기타 6

  • GitBook이 Vercel에서 30,000개 문서 사이트를 단일 배포로 운영하는 사례를 소개합니다.
  • 월 1억 2천만 페이지뷰를 엣지에서 제공한다고 설명합니다.
  • 하루 40,000건의 캐시 무효화를 처리합니다.
  • AI 크롤러와 자동화 시스템이 전체 트래픽의 41%를 차지한다고 밝힙니다.
  • LLM과 자동화 시스템이 문서를 프로그램 방식으로 수집하는 트래픽 특성을 설명합니다.
  • adaptive documentation은 멀티테넌트 캐싱을 더 복잡하게 만들 수 있다고 언급합니다.

원문 제목 · How GitBook serves 30,000 sites with sub-second content updates