Next.js
naro는 Next.js 빌드 산출물을 Cloudflare Workers에서 돌아가게 바꿔준다. Next.js 16 이상은 vinext로 먼저 빌드하고, 잘 되지 않으면 @opennextjs/cloudflare로 돌아간다. 그 외에는 바로 @opennextjs/cloudflare를 쓴다. 서버 컴포넌트, 라우트 핸들러, 미들웨어가 전부 엣지에서 돈다.
- 감지 기준
next- 빌드 명령
npm run build- 출력 디렉터리
.open-next- 런타임
- 서버 (Cloudflare Worker)
- SPA 폴백
- 아니오
- 빌드 캐시
.next/cache
지원 버전
Next.js 15 이상. 14 이하는 빌드 전에 거절한다.
15.0~15.5.20 구간은 빌드는 되지만 로그에 경고가 붙는다. Cloudflare 어댑터가 명시한 지원 범위 밖이기 때문이다.
빌드 캐시
같은 브랜치의 배포 사이에 .next/cache를 넘겨준다. 바뀌지 않은 페이지는 다시 빌드하지 않는다.
배포하기
프로젝트 폴더 안에서 실행한다. 첫 배포가 프로젝트를 만들고 연결까지 해둔다.
npx naro-cli deploynpx naro-cli deploy --prod기본값 바꾸기
프레임워크 기본값을 따르지 않는 프로젝트라면, 프로젝트 설정 → 빌드 설정에서 빌드 스크립트와 출력 디렉터리를 바꾸면 된다.