NestJS에서 .nvmrc 파일을 사용하여 Node.js 버전을 관리

NestJS에서 .nvmrc 파일을 사용하여 Node.js 버전을 관리하는 방법을 단계별로 설명하겠습니다.

---

1. .nvmrc 파일 생성 및 설정

.nvmrc 파일은 프로젝트에서 사용할 Node.js 버전을 명시하는 파일입니다. 프로젝트 루트 디렉터리에 .nvmrc 파일을 생성하고, 원하는 Node.js 버전을 입력합니다.

echo "18.17.0" > .nvmrc

위 명령어는 .nvmrc 파일을 생성하고, Node.js 18.17.0 버전을 사용하도록 설정합니다. (버전은 프로젝트에 맞게 변경)

.nvmrc 파일을 열어 직접 수정할 수도 있습니다.

# .nvmrc 파일 내용
18.17.0

---

2. nvm(Node Version Manager) 설치 및 설정

.nvmrc를 사용하려면 nvm이 필요합니다. 먼저 nvm이 설치되어 있는지 확인하세요.

nvm --version

설치되어 있지 않다면, 다음 명령어를 실행하여 설치합니다.

Mac/Linux (bash/zsh)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.4/install.sh | bash

설치 후, 아래 명령어로 nvm을 사용할 수 있도록 설정합니다.

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

Windows (PowerShell) Windows 사용자는 nvm-windows 를 다운로드하여 설치해야 합니다.

설치 완료 후, 터미널을 다시 열고 nvm이 정상적으로 동작하는지 확인합니다.

nvm --version

---

3. .nvmrc 파일을 기반으로 Node.js 버전 설정

프로젝트 진입 시 자동으로 .nvmrc의 버전 사용하기

다음 명령어를 실행하면 .nvmrc에 지정된 버전을 자동으로 사용합니다.

nvm use

.nvmrc에 지정된 버전이 설치되어 있지 않다면, nvm이 자동으로 해당 버전을 설치하라고 요청할 수 있습니다.

만약 해당 버전이 설치되지 않았다면, 아래 명령어로 직접 설치할 수 있습니다.

nvm install

또는 명시적으로 버전을 지정하여 설치할 수도 있습니다.

nvm install 18.17.0

설치 후, 해당 버전을 기본으로 설정하려면:

nvm alias default 18.17.0

---

4. .nvmrc를 활용한 개발 환경 설정 자동화

프로젝트에 진입할 때 .nvmrc를 자동으로 로드하려면, zsh, bash, fish 등의 셸 설정 파일(.zshrc, .bashrc 등)에 다음 내용을 추가하세요.

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

cd "$(dirname "$0")"
if [ -f .nvmrc ]; then
  nvm use
fi

이제 터미널에서 프로젝트 디렉터리에 진입하면 자동으로 .nvmrc에 지정된 Node.js 버전이 활성화됩니다.

---

5. NestJS 프로젝트에서 .nvmrc 활용하기

NestJS 프로젝트에서 .nvmrc를 적용하면, 모든 팀원이 동일한 Node.js 버전을 사용하여 일관된 개발 환경을 유지할 수 있습니다.

1. .nvmrc 파일을 추가하여 버전을 통일합니다.
2. 모든 팀원이 nvm use를 실행하도록 합니다.
3. 프로젝트 실행 전에 Node.js 버전을 확인하려면:

node -v

.nvmrc 버전이 다를 경우, 아래 명령어를 실행하세요.

nvm use

---

6. .nvmrc 사용 시 주의사항

• .nvmrc에 지정된 버전이 nvm install을 통해 설치되어 있어야 합니다.
• Windows에서는 nvm-windows를 사용해야 하며, 일부 nvm 기능이 다르게 동작할 수 있습니다.
• .nvmrc는 프로젝트 루트 디렉터리에 있어야 자동으로 감지됩니다.
• nvm이 기본으로 설치되지 않은 CI/CD 환경에서는 Node.js 버전을 명시적으로 설치해야 합니다.

---

결론

NestJS 프로젝트에서 .nvmrc를 사용하면 개발자 간 Node.js 버전을 일관되게 유지할 수 있으며, nvm use를 통해 쉽게 변경이 가능합니다. 또한 CI/CD에서 안정적인 환경을 유지하는 데에도 유용합니다.

이제 .nvmrc 파일을 추가하고 nvm을 활용하여 NestJS 프로젝트의 Node.js 버전을 효율적으로 관리해보세요!

---

블로그로 내보낼까요?