Nest.js 살펴보기 #1 - 환경 구성

Nest.js 살펴보기 #1 - 환경 구성

조대협 (http://bcho.tistory.com)

 

Nest.js 를 사용하기 위해서 먼저 환경을 구성해보자

 

Node.js 설치

가장 먼저 Node.js를 설치해야 한다. Node.js는 Nest.js 애플리케이션을 실행하는 데 필요한 런타임 환경을 제공한다. Node.js 공식 웹사이트(https://nodejs.org/)에서 운영체제에 맞는 설치 파일을 다운로드 받을 수 있다. LTS(Long Term Support) 버전을 다운로드하는 것을 권장한다. 다운로드한 설치 파일을 실행하여 Node.js를 설치한다. 설치 과정에서 npm(Node Package Manager)도 함께 설치되는데, npm은 Node.js 패키지를 관리하는 도구이다.

설치가 완료되면 터미널 또는 명령 프롬프트를 열고 다음 명령어를 실행하여 Node.js와 npm이 제대로 설치되었는지 확인할 수 있다.

node -v
npm -v

각각 Node.js와 npm의 버전이 출력되면 정상적으로 설치된 것이다.

 

Nest.js 설치

Node.js 설치가 완료되었으면, Nest.js CLI(Command Line Interface)를 사용하여 Nest.js 프로젝트를 생성할 수 있다. Nest.js CLI는 Nest.js 프로젝트를 생성하고 관리하는 데 필요한 도구를 제공한다. 다음 명령어를 사용하여 Nest.js CLI를 전역으로 설치한다.

npm install -g @nestjs/cli

-g 옵션은 Nest.js CLI를 전역으로 설치하여 시스템 어디에서나 nest 명령어를 사용할 수 있도록 한다. 설치가 완료되면 다음 명령어를 실행하여 Nest.js CLI가 제대로 설치되었는지 확인할 수 있다.

nest -v

Nest.js CLI 버전이 출력되면 정상적으로 설치된 것이다.

 

Nest.js 프로젝트 생성

Nest.js CLI를 사용하여 새로운 Nest.js 프로젝트를 생성할 수 있다. 다음 명령어를 실행하여 새로운 Nest.js 프로젝트를 생성한다.

nest new project-name

 

project-name은 프로젝트의 이름으로, 원하는 이름으로 변경할 수 있다. 명령어를 실행하면 프로젝트를 생성할 디렉토리가 생성되고, 필요한 파일과 패키지가 자동으로 설치된다. 설치 과정에서 사용할 패키지 매니저를 선택하라는 메시지가 나타날 수 있다. npm, yarn, pnpm 중에서 선택할 수 있다. 특별한 이유가 없다면 npm을 선택해도 된다.

프로젝트 생성이 완료되면 프로젝트 디렉토리로 이동한다.

cd project-name

 

Nest.js 애플리케이션 실행

프로젝트 디렉토리로 이동한 후 다음 명령어를 실행하여 Nest.js 애플리케이션을 실행할 수 있다.

npm run start:dev

이 명령어는 개발 모드로 애플리케이션을 실행한다. 개발 모드에서는 파일이 변경될 때마다 애플리케이션이 자동으로 재시작된다. 애플리케이션이 성공적으로 실행되면 터미널에 다음과 같은 메시지가 출력된다.

[Nest] 30160  - 2025-02-13, 05:54:44     LOG [NestFactory] Application context created +0ms
[Nest] 30160  - 2025-02-13, 05:54:44     LOG [InstanceLoader] AppModule dependencies initialized +5ms
[Nest] 30160  - 2025-02-13, 05:54:44     LOG [RoutesResolver] AppController {/}: +3ms
[Nest] 30160  - 2025-02-13, 05:54:44     LOG [RouterExplorer] Mapped {/, GET} route +1ms
[Nest] 30160  - 2025-02-13, 05:54:44     LOG [NestApplication] Nest application successfully started +2ms

이제 웹 브라우저를 열고 http://localhost:3000에 접속하면 Nest.js 애플리케이션의 기본 페이지를 확인할 수 있다.

이것으로 Nest.js 튜토리얼을 위한 기본적인 환경 구성이 완료되었다.