사용 가이드

Next.js 배포

Next.js 앱의 빌드, 실행, 이미지 및 리전 설정을 안내합니다.

설치된 Next.js가 16.2 이상이면 ntro deploy가 프로젝트의 package.json에서 Next.js를 감지합니다. 기본적으로 빌드 스크립트를 실행하고 정적 파일, 프리렌더 결과 및 서버 실행에 필요한 파일을 준비합니다. output: 'standalone'을 별도로 설정할 필요는 없습니다. App Router의 SSG·SSR·ISR·API 라우트와 스트리밍을 사용하는 예시는 저장소의 examples/hello-next입니다.

ntro apps create my-next-app
ntro deploy . --app my-next-app --prod

실행할 컴퓨트 리전은 프로젝트 루트의 nitroship.json에 지정하거나 CLI에서 --regions를 전달합니다. 동일한 항목은 CLI 플래그가 우선합니다.

{
  "compute": {
    "regions": ["kr-sel", "jp-tyo"],
    "tier": "standard"
  }
}

리전은 하나 이상 필요합니다. --tier는 standard|large, --min-instances는 0..32, --max-instances는 1..32이며 최소값은 최대값보다 클 수 없습니다. 최소 인스턴스 수는 현재 프로덕션 배포에서만 적용됩니다. --skip-build는 이미 준비한 관리형 Next.js 어댑터 출력을 재사용할 때만 사용합니다.

Next.js의 기본 이미지 최적화 설정은 어댑터가 자동으로 반영합니다. 별도의 nitroship.json images 블록을 추가하면 오류가 발생하므로 Next.js 이미지 설정은 next.config에서 지정합니다. 이미지 최적화를 참고합니다.