목차
cdnjs로 한도를 넓힌 Cloudflare Developer Platform (2026-07)
원문 정보
- 원문: Dogfooding at scale: migrating cdnjs to Cloudflare’s Developer Platform
- 매체 · 게시일: The Cloudflare Blog · 2026-07-30
- 저자: Simona Badoiu
- 원문 내용을 바탕으로 재구성한 요약입니다.
고칠 때마다 세 곳을 오가던 cdnjs
기존 cdnjs는 캐시 적중률 98%로 수십억 건의 요청을 장애 없이 처리했습니다. 파일 제공은 잘 돌아갔습니다. 고치기 어려운 쪽은 게시 파이프라인이었습니다. 기능을 더하거나 패키지 처리 오류를 수정하려면 GCP Functions, VM, Cloudflare 사이에서 배포를 조율해야 했습니다.
2020년 서버리스 이전에서 옮긴 범위는 파일 제공 경로였습니다. Workers와 KV가 파일을 제공하고 bare-metal 원본 서버가 대체 경로를 맡았으며, Brotli와 gzip 사전 압축도 도입했습니다. 게시 작업은 GCP에 남았습니다. 당시 Workers에는 큰 배포 압축 파일을 가져와 CPU 집약적인 처리를 수행하고, 수 시간에 걸친 작업을 조율할 구성 요소가 없었기 때문입니다.
가장 고통스러운 일은 로그를 손으로 이어 붙이는 작업이었습니다. 업데이트 하나가 Cloud Functions, GCS 객체 이벤트, Pub/Sub, git-sync VM, Workers KV를 거쳐도 공통 상관관계 ID가 없었습니다. GCP Logging과 Cloudflare Logpush에 각각 기록이 남았지만, 둘을 연결할 공통 키는 없었던 것입니다.
특히 부분 성공이 문제였습니다. KV에 파일을 쓴 뒤 GitHub 저장소 반영에 조용히 실패해도 사용자에게는 수 주 동안 정상적으로 파일을 제공할 수 있었습니다. 전체 파이프라인 상태를 아는 시스템이 없으니 불일치를 알릴 수도 없었습니다. GitHub를 기준 저장소로 삼았지만, 실제로는 KV와 GitHub 중 어느 쪽을 따라 내용을 바로잡을지 명확하지 않았습니다.
단계 사이의 연결도 스토리지에 의존했습니다. 함수가 버킷에 파일을 쓰면 새 객체 이벤트가 다음 함수를 깨우는 방식입니다. 스토리지가 메시지 큐까지 맡았지만 dead-letter queue도, 밀린 작업을 확인할 방법도, 실패한 단계를 깔끔하게 재실행할 수단도 없었습니다. npm 업데이트 확인에만 알파벳별로 26개 함수를 배포했고, 정상 동작 여부를 알려면 로그도 26곳을 확인해야 했습니다.
git-sync가 처리 결과를 쌓은 GitHub 저장소는 packed storage 기준 1.1TB를 넘었습니다. GitHub의 아카이브 서비스조차 tarball이나 zip을 만들지 못하는 크기였습니다. 포크는 사실상 어려워지고 복제는 느려졌습니다. 수작업으로 관리한 예외 274개가 담긴 .gitignore는 파이프라인 앞단에서 제대로 거부하지 못한 릴리스들의 묘지였습니다.
15년간 웹에 남은 cdnjs 주소
그렇게 오래된 시스템을 계속 개선하려는 데는 이유가 있습니다. cdnjs는 JavaScript와 CSS 라이브러리를 무료로 제공하는 오픈 소스 CDN입니다. 가입도 API 키도 필요 없고 요청 속도 제한도 없습니다. <script> 태그 하나로 jQuery, Bootstrap, Lodash를 Cloudflare 엣지에서 불러옵니다.
번들러가 보편화된 지금도 하루 요청량은 90억 건입니다. 그 이유 중 하나는 LLM입니다. ChatGPT, Claude, Cursor가 간단한 HTML 데모를 만들 때 cdnjs를 즐겨 찾습니다. 15년간 쌓인 튜토리얼, README, 질의응답에 cdnjs 주소가 등장했고, 일관된 URL 형식과 바뀌지 않는 버전 덕분에 모델이 의존성을 안정적으로 생성하기 쉽다는 설명입니다.
파일마다 검증에 쓰는 SRI 해시가 있고, 미러를 감사할 수 있으며, 프로젝트 전체가 오픈 소스입니다. 단, 구 시스템의 버그로 기존에 저장된 해시가 실제 파일과 모두 일치하도록 보장하는 작업은 아직 진행 중입니다.
이전을 되돌린 SRI 해시
이전 시도는 한 번 실패한 적이 있습니다. 기존 패키지를 다시 처리해 R2에 기록했더니 KV가 제공하던 파일과 바이트가 달라졌습니다. 최소화 도구와 압축기는 버전이 달라져도 늘 같은 출력을 보장하지 않습니다. 새 출력이 올바르더라도 SRI 해시는 달라질 수 있고, HTML에 해시를 고정해 둔 사용자에게는 파일 제공이 깨지는 문제였습니다. 결국 이전을 롤백했습니다.
이번에는 기존 내용을 그대로 옮겼습니다. KV에서 제공하던 파일을 재생성하지 않고 R2로 복사해 바이트를 보존하는 방식입니다. 해결할 문제도 달라졌습니다. 수백만 파일을 다시 처리하는 대신, 계정 사이에서 하나도 빠뜨리지 않고 복사해야 했습니다.
파일의 단일 기준이 된 R2
2026년 6월 23일부터 cdnjs는 Cloudflare Developer Platform에서 전체 서비스를 운영하고 있습니다. 새 구성에서 파일 내용의 기준은 R2 하나입니다. 실용적인 크기 제한이 없어, KV에 담지 못했던 source map과 대형 번들, 폰트 묶음도 함께 보관합니다. S3 API로 전체 카탈로그를 열어 두어 S3 클라이언트로 접근할 수도 있습니다.
KV에는 패키지 정보, 버전 목록, SRI 해시만 남겼습니다. 읽기는 많고 쓰기는 드문 메타데이터에 맞는 역할입니다. Worker 앞의 별도 내부 캐시 계층도 Developer Platform이 관리하는 계층형 캐시인 Workers Cache로 교체했습니다.
파일의 기준은 하나지만 사본은 따로 둡니다. R2에 게시한 모든 파일을 DigitalOcean Spaces에도 복제해 재해 복구용으로 보관하며, 실제 요청의 대체 경로로도 사용합니다. 제공 순서는 캐시 → R2 → DigitalOcean입니다. R2가 파일을 반환하지 못하면 Worker가 DigitalOcean에서 읽으므로, R2에 문제가 생겨도 cdnjs가 함께 멈추지 않도록 했습니다.
전환 기간에는 Cloudflare가 호스팅하는 원본 서버도 경로에 남아 있습니다. GitHub 자료를 R2로 모두 옮기면 퇴역할 예정입니다. 기존 게시 파이프라인을 폐기하면서 보안 패치와 감사가 필요한 구성 요소도 줄었습니다. Cloudflare는 이 과정에서 최근 제기된 cdnjs 취약점도 모두 해소했다고 설명합니다.
압축 결과를 기다리는 Workflows
새 게시 파이프라인은 10분마다 cron이 실행하는 PackageUpdatesWorkflow에서 시작합니다. npm과 GitHub에서 새 버전을 찾으면 DownloadPackageWorkflow가 배포 압축 파일을 R2로 가져옵니다. 이어 파일별 ProcessingWorkflow가 추출·최소화·압축을 처리하고, 마지막 PublishingWorkflow가 R2와 KV에 결과를 기록하며 Algolia 검색 인덱스를 갱신합니다.
이제 각 단계의 상태가 남습니다. 네트워크 시간 초과나 압축 오류가 발생해도 Workflows가 마지막으로 성공한 단계부터 실행을 재개합니다. 스토리지 이벤트로 연결했던 함수들의 진행 상태를 Workflows가 관리하게 된 것입니다.
압축에는 컨테이너를 사용합니다. 초기 이전 당시 처리 알고리즘이 라이브러리 전체를 메모리에 담아야 했기 때문입니다. 파일별 ProcessingWorkflow는 압축 전 파일을 R2 버킷에 쓰고 Queue로 작업을 보낸 뒤 잠듭니다. 컨테이너에서 실행되는 Rust 압축 서비스가 결과를 다른 버킷에 기록하면, R2 이벤트 알림이 워크플로를 깨워 다음 처리를 이어갑니다. 이 로직을 Worker로 옮기기 위해 알고리즘에 스트리밍을 지원하는 방안도 검토 중입니다.
부모 워크플로의 기다림은 더 깁니다. 파일 수천 개가 든 패키지라면 병렬로 실행되는 자식 수천 개가 모두 끝나야 게시를 시작할 수 있습니다. 여기에는 작은 Durable Object를 카운터로 사용합니다. 부모가 자식을 생성할 때 값을 늘리고 자식이 완료되면 줄여, 값이 0이 되었을 때 부모를 깨웁니다.
이전 작업에서 넓어진 플랫폼 한도
기존 파일을 그대로 복사하기로 해도 처리량의 제약은 남았습니다. 당시 유료 플랜의 Workers 하위 요청 한도는 호출당 1,000개였습니다. 파일이 수천 개인 패키지는 한 번의 실행으로 이 한도를 소진했습니다. 호출마다 같은 한도가 적용되므로 단순 병렬화만으로는 해결되지 않았습니다.
이전 작업을 패키지 이름으로 나누고 Queues를 써서 여러 Worker 호출에 분배했습니다. Queues의 최소 한 번 전달 보장은 패키지가 조용히 누락되는 일을 막았습니다. 이전 중에는 Workflow당 1,024단계라는 한도에도 도달했습니다.
Cloudflare는 우회 방법을 찾는 데서 멈추지 않고 Workers와 Workflows 담당 팀에 한도 확대를 요청했습니다. 그 결과 유료 플랜의 하위 요청은 호출당 최대 1,000만 개로 늘었습니다. Workflow 단계는 기본 10,000개이며, 설정으로 최대 25,000개까지 늘릴 수 있습니다. cdnjs가 부딪힌 한도를 넓힌 결과는 다른 플랫폼 사용자에게도 제공됩니다.
다음 후보로 떠오른 ES Modules
새 게시 파이프라인에서는 브라우저가 직접 가져올 수 있는 ES Modules도 검토 대상입니다. 지금 파일을 사전 압축하는 Workflows와 Containers 조합으로, 게시할 때 패키지를 변환하는 방안입니다. 구현을 약속한 기능은 아닙니다. 1년 전에는 검토하기 어려웠던 가능성이 새 구성에서 열렸습니다.
서비스 규모와 이전 과정의 세부 수치·설정값
| 항목 | 값 |
|---|---|
| 프로젝트 출발과 Cloudflare 참여 | 2011년 Ryan Kirkman과 Thomas Davis가 시작, 수개월 뒤 Cloudflare가 무료 호스팅 제공, 2019년 유지보수 인수 |
| 앞선 서버리스 이전 | 2020년 파일 제공 경로를 Workers와 KV로 이전, 게시 경로는 GCP에 유지 |
| 웹사이트 사용 비율 | 전체 웹사이트의 약 12% |
| JavaScript CDN 시장 점유율 | 48.3% |
| 평균 요청량 | 초당 108,000건, 하루 90억 건 |
| 제공 거점 | Cloudflare 데이터센터 330곳 이상 |
| 캐시 적중률 | 현재 서비스 소개 수치 98.6%, 이전 구성 설명 수치 98% |
| 기존 npm 업데이트 확인 함수 | 알파벳별 1개씩 총 26개 |
| 기존 GitHub 저장소 크기 | packed storage 기준 1.1TB 초과 |
기존 .gitignore 예외 | 수작업으로 관리한 항목 274개 |
| 새 버전 확인 주기 | 10분마다 cron이 PackageUpdatesWorkflow 실행 |
| Workers 하위 요청 한도 | 유료 플랜에서 호출당 기존 1,000개, 확장 후 최대 1,000만 개 |
| Workflow 단계 한도 | 기존 1,024단계, 확장 후 기본 10,000단계, 설정으로 최대 25,000단계 |