NVM(노드 버전 관리자)은 다양한 프로젝트를 위해 여러 Node.js 버전 간에 자주 전환하는 Node.js 개발자에게 없어서는 안 될 도구입니다. 레거시 애플리케이션을 유지 관리하든, 최신 기능을 실험하든, 아니면 단순히 프로젝트마다 다른 버전이 필요한지 NVM을 사용하면 삶이 훨씬 쉬워집니다. 이 블로그에서는 NVM에 대해 자세히 알아보고 Node.js 버전을 효율적으로 관리하기 위한 고급 기술과 모범 사례를 살펴보겠습니다.

NVM을 사용하는 이유는 무엇입니까?

NVM의 고급 사용법을 알아보기 전에 NVM을 사용해야 하는 이유를 빠르게 요약해 보겠습니다.

1. 버전 관리: 여러 Node.js 버전 간을 쉽게 전환합니다.
2. 환경 격리: 각 프로젝트가 충돌 없이 필수 Node.js 버전을 사용하는지 확인하세요.
3. 편의성: Node.js 버전의 설치 및 업데이트를 단순화합니다.

NVM 설치

Unix 기반 시스템(Linux/macOS)의 경우

Unix 기반 시스템에서 NVM을 시작하려면 NVM을 설치해야 합니다. 설치 과정은 간단합니다:

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

스크립트를 실행한 후 .bashrc, .zshrc 또는 .profile 파일에 다음 줄을 추가합니다.

export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

쉘 구성을 다시 로드하세요:

source ~/.bashrc  # or ~/.zshrc, ~/.profile depending on your shell

윈도우의 경우

Windows의 경우 Windows 환경에 맞춰진 유사한 도구인 nvm-windows를 사용할 수 있습니다.

1. nvm-windows 저장소에서 설치 프로그램을 다운로드하세요.
2. 설치 프로그램을 실행하고 화면의 지시를 따르세요.

설치 후 새 명령 프롬프트를 열고 설치를 확인합니다.

nvm version

기본 사용법

NVM이 설치된 상태에서 몇 가지 기본 명령을 살펴보겠습니다.

Node.js 버전 설치

Node.js 버전을 지정하여 설치할 수 있습니다.

nvm install 14.20.1  # Install Node.js 14.20.1
nvm install 18.0.0   # Install Node.js 18.0.0

설치된 버전 나열

설치된 모든 Node.js 버전을 보려면:

nvm ls

특정 버전 사용

현재 세션의 특정 버전으로 전환:

nvm use 14.20.1

기본 버전 설정

모든 새 셸에서 사용할 기본 Node.js 버전을 설정합니다.

nvm alias default 14.20.1

고급 NVM 사용법

이제 기본 사항을 익혔으니 고급 NVM 기술을 살펴보겠습니다.

.nvmrc 파일 작업

.nvmrc 파일은 프로젝트의 Node.js 버전을 지정할 수 있습니다. 원하는 Node.js 버전이 포함된 프로젝트의 루트 디렉터리에 .nvmrc 파일을 만듭니다.

14.20.1

프로젝트 디렉터리로 이동할 때 다음 명령을 사용하여 지정된 버전으로 전환합니다.

nvm use

다음 디렉토리에 CD를 넣을 때 버전을 자동으로 로드하는 셸 기능을 사용하여 이 프로세스를 자동화할 수 있습니다.

# Add this to your .bashrc or .zshrc
autoload -U add-zsh-hook
load-nvmrc() {
  if [[ -f .nvmrc ]]; then
    nvm use
  fi
}
add-zsh-hook chpwd load-nvmrc
load-nvmrc

특정 Node.js 변형 설치

NVM을 사용하면 io.js 또는 다양한 LTS 버전과 같은 다양한 Node.js 변형을 설치할 수 있습니다.

nvm install iojs
nvm install --lts

새 버전 확인

다음을 통해 Node.js 버전을 최신 상태로 유지하세요.

nvm ls-remote

이 명령은 사용 가능한 모든 Node.js 버전을 나열하여 새 버전이 출시되었는지 확인할 수 있습니다.

Node.js 버전 제거

사용하지 않는 Node.js 버전을 제거하여 공간을 확보하세요.

nvm uninstall 14.20.1

스크립트 자동화

자동화 및 CI/CD 파이프라인의 경우 스크립트 내에서 NVM을 사용할 수 있습니다. 다음은 bash 스크립트에서 NVM을 사용하는 방법에 대한 예입니다.

#!/bin/bash

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

nvm install 14.20.1
nvm use 14.20.1

node -v

글로벌 패키지 관리

글로벌 패키지는 Node.js 버전별로 설치됩니다. 이를 효율적으로 관리하려면 nvm의 install-packages 명령을 사용하십시오:

nvm install 18.0.0
nvm reinstall-packages 14.20.1

이 명령은 버전 14.20.1에서 18.0.0까지의 모든 글로벌 패키지를 다시 설치합니다.

도커와 함께 사용

Docker를 사용하는 프로젝트의 경우 NVM을 사용하여 Node.js를 설치하면 Dockerfile을 간소화할 수 있습니다.

FROM ubuntu:20.04

# Install dependencies
RUN apt-get update && apt-get install -y curl

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

# Set up NVM environment
ENV NVM_DIR /root/.nvm
ENV NODE_VERSION 14.20.1
RUN . $NVM_DIR/nvm.sh && nvm install $NODE_VERSION

# Ensure Node.js is available
ENV PATH $NVM_DIR/versions/node/v$NODE_VERSION/bin:$PATH

# Verify installation
RUN node -v

문제 해결 및 팁

일반적인 문제

1. NVM 명령을 찾을 수 없음: 셸 구성 파일이 NVM을 올바르게 소싱하고 있는지 확인하세요.
2. 권한 문제: 적절한 권한으로 명령을 실행하거나 NVM 설치 경로를 조정하세요.

모범 사례

1. NVM을 정기적으로 업데이트: 새로운 기능과 버그 수정을 활용하려면 NVM 자체를 업데이트하세요.
2. .nvmrc 파일 사용: 개발 환경과 CI 파이프라인 전반에 걸쳐 일관성이 보장됩니다.
3. 글로벌 패키지 관리: 일관성을 유지하기 위해 Node.js 버전 전반에 걸쳐 글로벌 패키지를 정기적으로 동기화합니다.

결론

NVM은 Node.js 개발 워크플로우를 대폭 간소화할 수 있는 강력한 도구입니다. NVM을 마스터하면 여러 Node.js 버전을 손쉽게 관리하고, 프로젝트 호환성을 보장하며, 깔끔한 개발 환경을 유지할 수 있습니다. 노련한 개발자이든 이제 막 Node.js를 시작하는 개발자이든 NVM을 툴킷에 통합하면 생산성과 유연성이 향상됩니다.

즐거운 코딩하세요!