Next.js 페이지에서는 빌드 시점과 런타임 환경변수를 구분하고, 설치·빌드·시작 명령과 리소스 설정을 입력해 서비스를 배포하는 방법을 안내합니다.

배포 설정 참고사항

프로젝트 설정 파일(package.json, .nvmrc 등)에 명시된 Node.js 버전과 배포 설정 시 선택한 버전이 일치하지 않으면 빌드 및 런타임 오류가 발생할 수 있습니다.
Next.js 어플리케이션을 배포하는 경우 빌드 시점에 외부의 값을 주입하는 것과 런타임 시점에 값을 참조하는 경우를 구분하여 빌드인자 혹은 환경변수를 세팅해야 합니다.
  • 빌드인자(Build Arguments): 빌드 시 인자의 값을 주입
  • 환경변수(Environment Variables): 런타임 시점에 값을 참조

​
템플릿과 저장소 선택

대시보드의 또는 ⌘ + K 로 생성되는 배포 창에서 Next.js 템플릿을 선택하고, 이어지는 드롭다운 메뉴에서 연동된 GitHub 계정의 저장소를 선택하거나 Git URL 탭에서 Git 저장소 URL을 입력하세요.

​
배포 설정값 입력

다음의 각 항목에 서비스를 배포하기 위한 설정값을 입력하세요.
  • 버전
  • 환경변수
  • 포트번호
  • Install Command: npm/yarn 패키지 설치 명령어
  • Build Command: npm/yarn 빌드 명령어
  • Start Command: node 실행 명령어
  • 무중단 배포: 컨테이너 상태 검증 엔드포인트
  • Build Variables: 컨테이너 이미지 빌드 시 포함되어야 하는 변수
  • Output Directory: 빌드 산출물 디렉터리
  • Include files in build: 프로젝트 빌드 시 필요한 파일 혹은 디렉터리 경로
  • Update strategy
    • Rolling Update: 새로운 버전의 서비스 배포 시점에 기존 파드 종료, 노드 가용자원 확보 필요
    • Recreate: 모든 서비스 종료후 새로운 버전의 서비스를 생성 및 구동하여 다운타임 발생
  • .npmrc: npm 패키지 레지스트리 경로, 프록시 등 설정

​
성능(리소스) 설정 및 배포

  • 리소스 유형 : 온디맨드 리소스와 스팟 리소스 중 선택
  • CPU : 서비스가 사용할 수 있는 vCPU 리소스의 최대값으로, ‘최소’ 선택 시 0.1 vCPU로 설정됩니다.
  • 메모리 : 서비스가 사용할 수 있는 메모리 리소스의 최대값
  • 동시실행(레플리카) : 설정한 수만큼 서비스가 수평확장되어 부하 분산 및 안정성 확보
  • 배포 : 배포하기 클릭
배포가 완료되면 프리뷰 도메인을 통해 브라우저로 웹 페이지를 조회하거나 API 툴을 사용해 요청을 보낼 수 있습니다.
리소스 제한으로 배포할 수 없는 경우 스페이스와 리소스 관리를 참고해 스페이스에 리소스를 추가하세요.
Next.js Docs