정적 구현 guide
External Rewrite 캐싱
문서와 정적 자산의 공개 호스트를 유지하면서 게이트웨이가 외부 원본 응답을 캐시하는 원리와 측정 방법을 설명합니다.
최종 수정일 2026-08-21
Gateway와 origin lifecycle
External rewrite는 브라우저를 gateway URL에 유지하면서 다른 origin에서 응답을 가져옵니다. Cold request에서는 두 프로젝트가 lifecycle에 참여할 수 있습니다. Gateway cache가 warm 상태가 되면 재사용 가능한 응답을 방문자 가까이에서 제공하여 origin 요청을 반복하지 않을 수 있습니다. Client 요청 수는 그대로인데 origin 활동이 감소하는지가 이 실험의 핵심입니다.
비교 가능한 deployment를 만들려면 caching을 명시해야 합니다. Enable flag는 rewrite 응답의 cache 가능 여부를 제어하고 CDN 전용 지시자는 freshness와 stale 동작을 지정합니다. 진단 header는 문서 body를 바꾸지 않고 어떤 설정과 origin이 응답을 만들었는지 알려줍니다.
Cache를 방해하지 않고 측정하기
Cookie, authorization 또는 변경되는 query parameter 없이 하나의 안정적인 URL에 순차 요청을 보냅니다. 각 요청의 status, cache 상태, PoP identifier, age, response bytes와 latency를 기록합니다. Browser hard reload는 no-cache 지시자를 추가할 수 있으므로 깨끗한 warm-cache sequence의 증거로 사용하기 어렵습니다.
Cache disabled와 enabled 실험은 요청 수, 위치, URL과 시간 범위를 동일하게 맞춥니다. Enabled 실험이 성공하면 warm HIT와 크게 감소한 origin 요청이 보여야 합니다. Dashboard 집계는 지연될 수 있고 프로젝트 간 transfer attribution이 다를 수 있으므로 최종 usage 표와 함께 probe 원본을 보존합니다.