Node.js 버전 관리 툴 Volta

※ 일본의 한 블로그 글을 번역한 포스트입니다. 오역 및 의역, 직역이 있을 수 있으며 틀린 내용은 지적해주시면 감사하겠습니다.

 

 

Volta란?

---

 Volta 는 JavaScript 도구 관리툴이다. 타이틀에서는 Node.js 의 버전 관리툴로 소개하고 있지만, npm·yarn 의 버전 관리도 할 수 있다. 공식 사이트 에서는 "The Hassle-Free JavaScript Tool Manager(수고 없는 JavaScript 도구 관리자)"라고 소개되어 있다.

 팀의 Node.js 버전 관리를 Volta에 통합한 결과 DX가 높아져 Volta 장점을 느끼게 됐다.이 포스트에서는 개발자의 Volta 인구를 늘리기 위해 Volta를 소개하고 사용하는 방법에 대해 설명하고자한다.

 

 

Volta 개요

---

공식 사이트에서 소개된 Volta의 3가지 특징을 살펴보도록 하겠다.

• Fast : Volta는 Rust로 제작되었으므로 다른 버전 관리 도구보다 더 빠르다.
• Reliable : 개인적으로 가장 장점을 부분으로 volta pin라는 명령을 사용하면 프로젝트 멤버의 Node.js 및 npm 버전을 쉽게 맞출 수 있다.
• Universal :  Windows · Mac · Linux. 모든 OS에서 작동한다. 

 

 

Volta의 특징

---

 Volta는 Node 엔진을 한 번 선택하면 그 이후에는 걱정할 필요가 없다. 프로젝트를 전환한다고 해도 Node를 수동으로 전환할 필요가 없다. 정기적으로 다시 설치하거나 왜 작동하지 않는지 확인하지 않고도 툴체인에 npm 패키지 바이너리를 설치할 수 있다. 

 다음의 커맨드 하나로 특정 버전의 노드를 사용할 수 있다.

$ volta install node@14

 그리고 공동 작업자를 위한 재현 가능한 환경을 커맨드 하나로 만들 수 있다.

$ volta pin node@12

 위 커맨드를 실행하면 Node 엔진의 버전을 package.json에 저장, 그 내용을 git에 커밋 할 수 있다. 따라서 프로젝트 디렉토리에서 Node를 실행할 때마다 Volta는 자동으로 package.json에 설정된 버전과 동일한 버전의 Node로 전환한다. 이로 인해 공동 연구자는 각 개발 머신에 Volta를 설치하여 동일한 환경을 구현할 수 있다.

 

 

Volta 설치하기

---

먼저 Node.js · npm 삭제

설치하기 전에 현재 사용중인 Node 버전 관리 도구를 제거하고 Node · npm을 사용할 수없는 상태로 만드는 것이 좋다. 툴 삭제에 관해서는 환경에 따른 패턴이 너무 많기 때문에 (nodebrew, NVM, nodist, ...) 삭제 방법에 대해서는 생략하도록 하겠다. 자신의 환경에 맞는 삭제 방법을 조사 후 실행하길 바란다.

Volta 설치

공식 Getting Started 에 따라 설치하면 된다. OS가 Mac / Linux (WSL 포함)이면 다음 커맨드로 쉽게 설치할 수 있다.

$ curl https://get.volta.sh | bash

Windows는 Windows Installer를 사용할 수 있으므로 공식 설명서에 따라 다운로드하여 실행하면 된다.

설치 확인

.zshrc파일등의 쉘의 설정 파일을 cat커멘드등으로 파일 내용을 살펴자. 이하의 패스가 통하고 있으면 OK다.

export VOLTA_HOME="$HOME/.volta"
export PATH="$VOLTA_HOME/bin:$PATH"

 그리고 터미널을 통해 volta 명령어를 사용할 수 있는지 확인해보자. 버전이 뜬다면 무사히 설치가 된 것이다.

$ volta --version

 

 

툴 체인 관리

---

Volta 툴체인이 관리하는 툴은 volta install과 volta uninstall 이 두 가지 커맨드로로 제어되게 된다.

특정 버전을 설정하여 Node의 기본 버전을 선택할 수 있습니다.

$ volta install node@14.15.5

 다음과 같이 정확한 버전을 지정하지 않는 경우 Volta쪽에서 적절한 버전을 선정하여 설치하게 된다.

$ volta install node@14

 그냥 최신 버전을 다운로드 받고 싶다면 latest를 사용하면 된다.

$ volta install node@latest

 앞서 말했듯 node이외에도 npm과 Yarn도 install 커맨드로 설치할 수 있다. 

 

 

프로젝트 관리

---

  Volt의 특징에서 설명했듯 공동 작업자 팀 또는 커뮤니티 프로젝트에 사용할 개발 도구를 표준화 할 수 있다.

Node 엔진 버전

volta pin명령을 사용하여 프로젝트의 Node 엔진 및 패키지 관리자 버전을 선택할 수 있다.

# Node의 버전 고정
$ volta pin node@14.17

# npm의 버전 고정
$ volta pin npm@6.14

 pin 명령어를 사용하면 Volta는 이를 package.json저장하므로 선택한 도구를 버전 관리에 커밋할 수 있게 된다. 즉, package.json에 다음과 같은 내용이 추가되게 된다.

"volta": {
  "node": "14.17.3",
  "npm": "6.14.13"
}

이 방법으로 Volta를 사용하여 프로젝트를 수행하는 모든 사람이 선택한 버전과 동일한 버전을 자동으로 가져 오게 된다.

node --version # 14.17.3
npm --version # 6.14.13

 

 

Volta 커맨드 옵션

---

공식 커맨드 레퍼런스는 이쪽 에서 확인 가능하다.

# 이용 방법
volta [FLAGS] [SUBCOMMAND]

# FLAGS
    --verbose   # 상세진단을 유효화
    --quiet     # 불필요한 출력을 없앰
-v, --version   # Volta의 현재 버전 표시
-h, --help      # 헬프정보 표시


# SUBCOMMANDS
fetch          # 로컬 머신에 툴을 패치
install        # 툴을 툴 체인에 설치
uninstall      # 툴을 툴 체인에서 삭제
pin            # 프로젝트의 런타임이나 패키지 매니저를 고정
list           # 현재 툴 체인을 표시
completions    # Volta컴플리트를 생성
which          # Volta가 호출한 실제 바이너리를 특정
setup          # 현재 유저/쉘에 대해 Volta를 유효화
help           # 메시지 혹은 지정된 서브 커맨드의 헬프 표시

---

참고자료

https://zenn.dev/taichifukumoto/articles/how-to-use-volta