Cloudflare가 Workers 로컬 개발 도구의 기반인 Miniflare v5를 공개했습니다. Wrangler, Cloudflare Vite 플러그인, @cloudflare/vitest-plugin을 통해 Miniflare를 사용하는 일반 프로젝트는 별도 조치가 필요하지 않지만, Miniflare를 직접 의존성으로 사용하거나 내부 API를 호출하는 도구는 설정 구조와 제거된 API를 확인해야 합니다.
주요 변경
- Miniflare 설정 구조가 테스트용 프로그래밍 방식 설정인
cloudflare.config.ts와 맞도록 변경됐습니다. - 기존 alpha D1 바인딩 등 deprecated API와 옵션,
wrappedBindings같은 내부 API가 제거됐습니다. - Miniflare의 내장 모듈 탐색이 제거되어 Wrangler나 Vite 플러그인 같은 상위 도구가 모듈 그래프를 제공해야 합니다.
- 로컬 전용
/cdn-cgi경로가/cdn-cgi/local아래로 이동하고, 리소스별 persistence 옵션은 공통 persistence root 방식으로 바뀌었습니다.
개발자 영향
일반적인 Workers 개발자는 기존처럼 wrangler dev나 Cloudflare Vite 플러그인을 사용하면 됩니다. 반면 테스트 도구, 프레임워크 통합, 자체 개발 서버처럼 Miniflare를 직접 호출하는 코드는 v5 마이그레이션 전 설정 객체와 제거된 API 사용 여부를 점검해야 합니다. 이번 변경은 앞으로 제공될 cf CLI 기반 로컬 개발 환경을 준비하는 성격도 있습니다.
원문 발표: · Cloudflare Workers
새 글 받아보기
RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.