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.json
에build
,dev
,lint
스크립트 포함 (예:"build": "tsc"
)
2. vercel.json 파일 생성
version
: 2builds
배열: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의 빌드 대상이 되어야 함