https://blog.plzhans.com/tags/build/Recent content in Build on plzhans blogHugoko-krFri, 11 Sep 2026 13:01:00 +0000https://blog.plzhans.com/posts/126-cloudflare-workers-wrangler-dev-deploy/Fri, 11 Sep 2026 13:01:00 +0000https://blog.plzhans.com/posts/126-cloudflare-workers-wrangler-dev-deploy/<p><picture> <source srcset="https://blog.plzhans.com/posts/126-cloudflare-workers-wrangler-dev-deploy/assets/1_3d822a0f-7e83-81f6-b43f-ee90a3347422_hu_696076b6bfb95313.webp" type="image/webp"> <img src="https://blog.plzhans.com/posts/126-cloudflare-workers-wrangler-dev-deploy/assets/1_3d822a0f-7e83-81f6-b43f-ee90a3347422_hu_5708cb739124f2fe.png" alt="로컬에서 돌린 워커 런타임이 그대로 엣지 플랫폼으로 올라가는 과정을 나타낸 대표 이미지" width="1200" height="630" loading="lazy"> </picture></p> <h2 id="개요">개요</h2> <blockquote> <p>이 글은 <a href="../124-cloudflare-workers-static-site-guide/">Cloudflare Workers 정적 사이트 가이드 - 배포부터 SEO까지</a> 시리즈의 일부다.</p> </blockquote> <p>Cloudflare Workers 를 다루는 일은 사실상 <strong><code>wrangler</code> 를 다루는 일</strong>이다. 로컬에서 띄우는 것도, 배포하는 것도 같은 CLI 다.</p> <p>그런데 이름 때문에 오해가 하나 생긴다. <strong><code>wrangler dev</code> 는 프론트 개발 서버가 아니다.</strong> 필자도 처음에 여기서 한참 헤맸다.</p> <h3 id="이-글에서-다루는-것">이 글에서 다루는 것</h3> <ul> <li>무엇을 설치해야 하는지 — 그리고 <strong>런타임 의존성은 늘지 않는다</strong>는 것</li> <li>워커 코드의 <strong>타입 설정을 분리</strong>해야 하는 이유</li> <li><code>wrangler dev</code> 가 실제로 무엇을 하는지 · <code>vite dev</code> 와의 차이</li> <li>왜 <strong>정적 사이트 빌드가 먼저</strong>여야 하는지</li> <li>워커가 응답을 고쳤는지 확인하는 방법</li> <li>배포 — 환경별 값 주입 · CI 에서 돌릴 때 주의할 것</li> </ul> <h3 id="다루지-않는-것">다루지 않는 것</h3> <p>Workers Static Assets 의 구조와 요청 흐름은 <a href="../125-cloudflare-workers-static-assets-routing-billing/">Cloudflare Workers 정적 사이트 호스팅 - 요청 흐름과 과금 기준</a>에 있다.</p>