환경 변수

Volta는 동작을 제어하는 여러 환경 변수를 따릅니다. 이 페이지는 사용 가능한 모든 환경 변수와 그 영향에 대한 참조 역할을 합니다.

핵심 환경 변수

VOLTA_HOME

다운로드된 도구와 구성을 포함하여 Volta가 데이터를 저장하는 디렉토리를 설정합니다.

• 기본값:
  • Unix: $HOME/.volta
  • Windows: %LOCALAPPDATA%\Volta
• 예제: VOLTA_HOME=/opt/volta

VOLTA_LOGLEVEL

Volta 로그 출력의 상세도를 제어합니다.

• 유효한 값: error, warn, info, verbose, debug
• 기본값: info
• 예제: VOLTA_LOGLEVEL=debug volta install node

VOLTA_SKIP_SETUP

1로 설정하면 설치 중에 Volta가 셸 구성 파일을 수정하는 것을 방지합니다.

• 유효한 값: 0, 1
• 기본값: 0
• 예제: VOLTA_SKIP_SETUP=1 bash -c "$(curl https://get.volta.sh)"

기능 플래그

VOLTA_FEATURE_PNPM

Volta에서 pnpm 지원을 활성화합니다.

• 유효한 값: 0, 1
• 기본값: 0
• 예제: VOLTA_FEATURE_PNPM=1 volta install pnpm

네트워크 구성

VOLTA_NETWORK_TIMEOUT_SECS

네트워크 작업의 타임아웃을 초 단위로 설정합니다.

• 기본값: 60
• 예제: VOLTA_NETWORK_TIMEOUT_SECS=120 volta install node

HTTP_PROXY / HTTPS_PROXY

Volta가 네트워크 요청에 사용하는 표준 프록시 환경 변수입니다.

• 예제:
  • HTTP_PROXY=http://proxy.example.com:8080
  • HTTPS_PROXY=http://proxy.example.com:8080

NO_PROXY

프록시를 우회해야 하는 호스트의 쉼표로 구분된 목록입니다.

• 예제: NO_PROXY=localhost,127.0.0.1,.example.com

설치 변수

VOLTA_LATEST_VERSION

Volta 설치 프로그램이 최신 버전 대신 특정 버전을 사용하도록 강제합니다.

• 예제: VOLTA_LATEST_VERSION=1.0.5 bash -c "$(curl https://get.volta.sh)"

VOLTA_TARGET_PROFILE

설치 프로그램이 수정해야 하는 셸 구성 파일을 지정합니다.

• 기본값: 현재 셸을 기반으로 자동 감지
• 예제: VOLTA_TARGET_PROFILE=$HOME/.bashrc

플랫폼별 변수

VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK

업데이트 알림에서 호환성 확인을 위한 최소 Volta 버전입니다.

• 예제: VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK=1.0.5

Windows 전용 변수

이러한 변수는 Windows 시스템에서만 사용됩니다:

VOLTA_REDIRECT_STDERR

1로 설정하면 Windows에서 stderr 출력을 stdout으로 리디렉션합니다.

• 유효한 값: 0, 1
• 기본값: 0

고급 사용법

VOLTA_UNSAFE_DIAGNOSTIC

디버깅용; 불안정할 수 있는 고급 진단을 활성화합니다.

• 유효한 값: 모든 문자열
• 예제: VOLTA_UNSAFE_DIAGNOSTIC=timing volta install node

VOLTA_STDIN_FILE_PASSTHROUGH

설정되면 Volta는 스크립트 실행을 위해 stdin 대신 이 파일 경로를 사용합니다.

• 예제: VOLTA_STDIN_FILE_PASSTHROUGH=/tmp/script.js volta run node

예제 구성

개발 환경

자세한 로그가 있는 개발 설정의 경우:

export VOLTA_HOME=$HOME/.volta
export VOLTA_LOGLEVEL=verbose
export PATH=$VOLTA_HOME/bin:$PATH

CI/CD 파이프라인

지속적 통합 환경의 경우:

export VOLTA_HOME=$HOME/.volta
export VOLTA_LOGLEVEL=error
export VOLTA_NETWORK_TIMEOUT_SECS=300
export PATH=$VOLTA_HOME/bin:$PATH

기업 네트워크

프록시 서버가 있는 환경의 경우:

export VOLTA_HOME=$HOME/.volta
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1,.internal.example.com
export PATH=$VOLTA_HOME/bin:$PATH