AI Store에서 AI코딩으로 만들어진 앱을 만나보세요!
지금 바로 방문하기

TypeScript Node.js 앱을 Vercel CLI로 배포하는 방법

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

DevOps

대상자

Node.js 및 TypeScript 프로젝트를 사용하는 백엔드 개발자 (중간 수준)

핵심 요약

  • 프로젝트 구조: src/, dist/, vercel.json, tsconfig.json 등 필수 파일/디렉터리 포함
  • vercel.json 구성: @vercel/node 사용, dist/server.js 빌드 대상 설정
  • 배포 명령: vercel --prod 실행 후 프로젝트 이름 및 디렉터리 지정

섹션별 세부 요약

1. 프로젝트 요구 사항

  • tsconfig.json이 올바르게 구성되어 있어야 함
  • npm run build 실행 시 dist/ 디렉터리에 JavaScript 파일 생성
  • package.jsonbuild, dev, lint 스크립트 포함 (예: "build": "tsc")

2. vercel.json 파일 생성

  • version: 2
  • builds 배열: dist/server.js@vercel/node 사용하여 빌드
  • routes 배열: 모든 요청을 dist/server.js로 라우팅

3. Vercel CLI 설치 및 로그인

  • npm install -g vercel로 CLI 설치
  • vercel login 실행 후 GitHub 또는 이메일로 로그인

4. 배포 프로세스

  • vercel --prod 명령 실행
  • 프로젝트 이름(library-management-api) 및 디렉터리(./) 지정
  • Vercel이 dist/server.js 파일을 기반으로 앱 빌드 및 배포

5. 배포 완료 후 확인

  • Vercel이 제공하는 두 개의 URL(검사 링크, 프로덕션 링크) 확인
  • 검사 링크를 브라우저에서 테스트 (인코그니토 모드 포함)

결론

  • 배포 후 생성된 도메인 링크를 반드시 테스트하여 정상 작동 여부 확인
  • vercel.json 파일의 정확한 설정과 npm run build 명령어는 배포 성공의 핵심 요소
  • dist/server.js 파일이 Vercel CLI의 빌드 대상이 되어야 함