개발 환경 설정

NestJS의 특징과 아키텍처에 대해 알아보았으니, 이제 NestJS 개발을 위한 환경을 직접 설정해볼 시간입니다. 걱정 마세요! 복잡하게 느껴질 수 있지만, 제가 단계별로 친절하게 안내해 드릴 테니 차근차근 따라오시면 됩니다.

Node.js 및 npm(또는 Yarn) 설치

NestJS는 Node.js 위에서 동작하는 프레임워크이므로, 가장 먼저 Node.js를 설치해야 합니다. Node.js를 설치하면 패키지 매니저인 npm(Node Package Manager) 도 함께 설치됩니다. npm은 NestJS 프로젝트를 생성하고 필요한 라이브러리를 설치할 때 사용됩니다.

만약 이미 Node.js가 설치되어 있다면, 터미널(또는 명령 프롬프트)을 열고 다음 명령어를 입력하여 버전을 확인해 보세요.

node -v
npm -v

최신 LTS(Long Term Support) 버전의 Node.js를 사용하는 것을 권장합니다. 만약 설치되어 있지 않거나 업데이트가 필요하다면, Node.js 공식 웹사이트에서 여러분의 운영체제에 맞는 설치 파일을 다운로드하여 설치해 주세요.

npm 대신 Yarn을 사용하고 싶다면?

Yarn은 npm과 유사한 또 다른 패키지 매니저입니다. npm보다 빠르고 안정적이라는 장점이 있어 많은 개발자가 선호하기도 합니다. 만약 Yarn을 사용하고 싶다면, Node.js 설치 후 다음 명령어를 통해 Yarn을 전역으로 설치할 수 있습니다.

npm install -g yarn

이 책에서는 주로 npm 명령어를 사용할 예정이지만, Yarn을 사용하시더라도 대부분의 명령어가 유사하거나 쉽게 변환 가능하니 걱정하지 않으셔도 됩니다.

NestJS CLI 설치

NestJS 개발의 효율성을 극대화하려면 NestJS CLI(Command Line Interface) 를 설치하는 것이 좋습니다. NestJS CLI는 프로젝트 생성, 컴포넌트(모듈, 컨트롤러, 서비스 등) 생성, 프로젝트 빌드 등 다양한 작업을 명령어로 손쉽게 수행할 수 있도록 도와줍니다.

터미널에 다음 명령어를 입력하여 NestJS CLI를 전역으로 설치합니다.

npm install -g @nestjs/cli

설치가 완료되면, 다음 명령어로 NestJS CLI의 버전을 확인하여 정상적으로 설치되었는지 확인할 수 있습니다.

nest -v

첫 NestJS 프로젝트 생성

이제 NestJS 개발 환경 설정의 마지막 단계입니다! NestJS CLI를 사용하여 우리의 첫 NestJS 프로젝트를 생성해 보겠습니다. 프로젝트를 생성할 디렉토리로 이동한 후, 다음 명령어를 입력하세요.

nest new project-name

여기서 project-name은 여러분이 만들고자 하는 프로젝트의 이름입니다. 예를 들어, my-nestjs-app이라는 이름으로 프로젝트를 생성하고 싶다면 다음과 같이 입력합니다.

nest new my-nestjs-app

명령어를 실행하면 NestJS CLI가 몇 가지 질문을 할 수 있습니다.

• "Which package manager would you like to use?": 사용할 패키지 매니저를 선택하라는 질문입니다. npm 또는 yarn 중 하나를 선택하고 Enter를 누르세요.

선택을 완료하면 NestJS CLI가 프로젝트에 필요한 파일과 폴더를 자동으로 생성하고, 의존성 패키지들을 설치하기 시작합니다. 이 과정은 잠시 시간이 소요될 수 있습니다.

프로젝트 실행 및 확인

모든 설치가 완료되면, 생성된 프로젝트 디렉토리로 이동하여 NestJS 애플리케이션을 실행해 볼 수 있습니다.

cd my-nestjs-app # 여러분이 지정한 프로젝트 이름으로 변경해주세요
npm run start:dev

npm run start:dev 명령어를 실행하면 NestJS 애플리케이션이 개발 모드로 시작됩니다. 이 모드에서는 코드 변경 시 자동으로 애플리케이션이 재시작되어 편리합니다.

애플리케이션이 성공적으로 실행되면, 터미널에 다음과 유사한 메시지가 출력됩니다.

[Nest] 12345   - 01/01/2023, 12:00:00 PM     LOG [NestFactory] Starting Nest application...
[Nest] 12345   - 01/01/2023, 12:00:00 PM     LOG [InstanceLoader] AppModule dependencies initialized +1ms
[Nest] 12345   - 01/01/2023, 12:00:00 PM     LOG [RoutesResolver] AppController {/}: +4ms
[Nest] 12345   - 01/01/2023, 12:00:00 PM     LOG [RoutesResolver] AppController {/hello, GET}: +4ms
[Nest] 12345   - 01/01/2023, 12:00:00 PM     LOG [NestApplication] Nest application successfully started +5ms

이제 웹 브라우저를 열고 http://localhost:3000으로 접속해 보세요. 화면에 "Hello World!"라는 메시지가 나타난다면, 여러분은 NestJS 개발 환경 설정을 성공적으로 마치신 겁니다!

지금까지 Node.js, NestJS CLI 설치부터 첫 NestJS 프로젝트 생성 및 실행까지 모든 과정을 함께 해보셨습니다. 이제 여러분은 NestJS 애플리케이션을 개발할 준비가 되었습니다.

다음 절에서는 이렇게 생성된 프로젝트의 기본 구조를 살펴보고, NestJS가 어떻게 동작하는지에 대한 큰 그림을 이해하는 시간을 갖겠습니다. 계속해서 '나 혼자 Nest.js'와 함께해주세요!