TECH 으로 돌아가기
TECH HACKER NEWS 7분 읽기 47 READS

친구에게만 '동적'인 정적 웹사이트, 캐시 무효화로 풀어낸 아키텍처

친구에게만 '동적'인 정적 웹사이트, 캐시 무효화로 풀어낸 아키텍처
SOURCE IMAGE · HACKER NEWS

개인 사이드 프로젝트를 만들 때 개발자는 흔히 두 가지 충동 사이에서 갈등한다. 하나는 '가까이 있는 망치로 일단 때려 해결하자'는 실용주의다. 이미지를 S3에 올리고 앞에 CDN을 붙이면 트래픽이 거의 없는 가족·지인용 사이트로는 충분하다. 다른 하나는 '콘텐츠가 거의 바뀌지 않으니 정적 사이트여야 한다'는 미학적 고집이다. 한 개발자가 자신의 그림과 스케치북을 온라인에 공유하기 위해 만든 아트 웹사이트의 설계 기록은, 이 두 충동을 어떻게 타협시켰는지를 구체적인 구현 수준에서 보여준다. 출발점은 소박했다. 그림마다 그린 장소를 지도 위 마커로 표시하자는 남동생의 아이디어에서 사이트가 시작됐다.

정적이면서 동적이어야 하는 모순

문제의 핵심은 요구사항 자체가 모순처럼 보인다는 데 있다. 콘텐츠가 하루 평균 0.3개꼴로밖에 바뀌지 않으니 서버에서 코드를 돌리거나 브라우저에서 자바스크립트로 페이지를 렌더링할 이유가 없다. 바이트가 그냥 준비된 채 놓여 있다가 전송되면 된다. 그러나 순수한 정적 사이트라면 새 그림을 올릴 때마다 파일을 추가하고 빌드를 돌려 배포해야 한다. 올해만 100점 가까이 그린 저자에게 이 과정은 번거로웠고, 태그를 달거나 위치를 지정하는 작업에는 결국 웹 기반 CRUD UI가 가장 편하다. 하지만 웹 UI가 사이트 콘텐츠를 바꾸는 순간 그것은 더 이상 정적 사이트가 아니다. 저자가 원한 것은 '남들에게는 정적이지만 나에게는 동적인' 사이트, 즉 깃허브 액션이나 터미널이 아니라 직접 만든 UI의 동작으로 트리거되는 빌드 시스템이었다.

캐시 무효화라는 한 줄짜리 해법

해법은 의외로 단순하다. 모든 HTML 페이지는 서버(Cloudflare 워커)에서 렌더링하되, 응답에 30일간 캐시하라는 헤더를 붙여 Cloudflare 인프라가 영구에 가깝게 보관하도록 한다. 그리고 새 그림을 올리거나 태그 집합을 바꾸는 등 쓰기 작업이 일어나면, 그 요청 핸들러가 캐시된 페이지 전체를 무효화한다. 그게 전부다. 이 구조의 매력은 비용과 자원 효율에 있다. 컴퓨팅과 대역폭은 무료 범위 안이고, 정적 자산은 거의 재생성되지 않은 채 캐시에 머문다. 사용자가 요청하면 이미 엣지에 놓여 있던 바이트가 그대로 전송되므로 빠르다. 인도에 있는 부모가 접속하면 인도 엣지 머신에 복제돼 한동안 그곳에 캐시된다. 저자는 생성 시점 타임스탬프를 페이지에 찍어 두어, Cloudflare가 워커를 다시 돌리지 않고 캐시된 산출물을 복사한다는 점을 실제로 확인했다.

이미지가 많은 사이트에서 이 방식이 잘 돌아가게 만드는 디테일이 하나 더 있다. 업로드 시점에 원본 외에 여러 작은 크기의 이미지를 미리 생성해 둔다는 것이다. 그것도 서버가 아니라 업로더의 브라우저, 즉 유일한 업로더인 저자 본인의 브라우저에서 처리한다. 썸네일과 카드에 거대한 원본을 그대로 보내면 너무 느리기 때문이다. Cloudflare에는 요청 시점에 리사이징해 캐시해 주는 이미지 서비스도 있지만, 저자는 필요한 세 가지 크기를 이미 알고 있으므로 미리 계산해 저장하는 편이 빠르다고 판단했다. 원본이 축소본보다 훨씬 크기 때문에 추가 저장 비용은 미미하다. 모든 작품의 메타데이터는 R2에 있는 단일 JSON 파일 하나에 담기고, 지도나 타임라인 같은 인터랙티브 요소는 이 JSON을 읽어 클라이언트에서 초기화될 뿐 서버에 아무것도 쓰지 않는다. 그래서 데이터베이스가 아예 없다.

실용주의가 이긴 지점, 그리고 한계

설계에는 저자 스스로 타협을 인정한 대목도 있다. 이상적으로는 편집이 일어났을 때 그 변경에 영향을 받는 페이지만 골라 무효화해야 한다. 좋은 빌드 시스템은 파일 하나가 바뀌면 그에 의존하는 산출물만 재컴파일한다. 그러나 이 사이트에서는 의존 관계가 어디에도 명시돼 있지 않다. 페이지 생성 코드는 그냥 실행될 뿐이고, 메타데이터 JSON의 어떤 변경이든 출력에 영향을 줄 가능성이 있다. 의존성을 일일이 인코딩하려다 틀리면 절반만 갱신된 사이트, 즉 정합성 버그가 생긴다. 새 작품이 #evening 태그를 달지 않았다면 해당 페이지는 바뀔 리 없다는 걸 알면서도, 저자는 세밀한 무효화를 정확히 구현하기가 너무 까다롭다고 보고 그냥 전부 무효화하기로 했다. 정합성을 성능 최적화보다 앞세운 판단이다.

한국의 실무자 관점에서 이 사례가 주는 함의는 분명하다. 첫째, '정적이냐 동적이냐'는 이분법이 아니라 읽기 경로와 쓰기 경로를 분리해 설계할 수 있는 문제라는 점이다. 읽기는 CDN 캐시에 맡기고, 쓰기 핸들러가 캐시 무효화를 책임지는 구조는 블로그·포트폴리오·사내 문서처럼 변경이 드문 콘텐츠에 폭넓게 응용할 수 있다. 둘째, 리사이징이나 전처리를 어디서 할지는 정답이 하나가 아니며, 입력 패턴이 고정돼 있다면 요청 시점 처리보다 사전 계산이 단순하고 빠를 수 있다는 점이다. 마지막으로 짚어둘 것은, 이 설계가 '업로더가 한 명'이라는 전제 위에서 깔끔하게 성립한다는 사실이다. 쓰기 주체가 많아지거나 무효화 빈도가 올라가면 전면 무효화의 비용과 캐시 미스가 달라지므로, 좋은 아이디어를 그대로 베끼기보다 자신의 트래픽과 변경 패턴에 맞춰 경계 조건을 다시 따져봐야 한다. 참고로 저자는 Cloudflare가 인수해 통합이 잘 된 Astro 프레임워크를 썼지만, 핵심은 프레임워크가 아니라 캐시의 세심한 관리에 있다고 못 박는다.

SOURCE · HACKER NEWS
원문 전체 보기 → https://klauria.tech/klauria-art/
SHARE
NEXT · CHOOSE

변화를 읽었다면,
내가 만들 수익 구조를 고릅니다.

정보를 더 모으는 데서 멈추지 않고, 광고·외주·판매·중개·구독 중 내 상황에 맞는 출발점을 정해보세요.

21가지 수익 구조 살펴보기 →
처리 중...