Variabili d'ambiente

Volta segue diverse variabili d'ambiente che controllano il suo comportamento. Questa pagina serve come riferimento per tutte le variabili d'ambiente disponibili e il loro impatto.

Variabili d'ambiente principali

VOLTA_HOME

Imposta la directory dove Volta memorizza i suoi dati, inclusi gli strumenti scaricati e la configurazione.

• Valore predefinito:
  • Unix: $HOME/.volta
  • Windows: %LOCALAPPDATA%\Volta
• Esempio: VOLTA_HOME=/opt/volta

VOLTA_LOGLEVEL

Controlla il livello di dettaglio dell'output di log di Volta.

• Valori validi: error, warn, info, verbose, debug
• Valore predefinito: info
• Esempio: VOLTA_LOGLEVEL=debug volta install node

VOLTA_SKIP_SETUP

Quando impostata su 1, impedisce a Volta di modificare i file di configurazione della shell durante l'installazione.

• Valori validi: 0, 1
• Valore predefinito: 0
• Esempio: VOLTA_SKIP_SETUP=1 bash -c "$(curl https://get.volta.sh)"

Flag delle funzionalità

VOLTA_FEATURE_PNPM

Abilita il supporto pnpm in Volta.

• Valori validi: 0, 1
• Valore predefinito: 0
• Esempio: VOLTA_FEATURE_PNPM=1 volta install pnpm

Configurazione di rete

VOLTA_NETWORK_TIMEOUT_SECS

Imposta il timeout per le operazioni di rete (secondi).

• Valore predefinito: 60
• Esempio: VOLTA_NETWORK_TIMEOUT_SECS=120 volta install node

HTTP_PROXY / HTTPS_PROXY

Variabili d'ambiente proxy standard utilizzate da Volta per le richieste di rete.

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

NO_PROXY

Lista separata da virgole degli host che dovrebbero bypassare il proxy.

• Esempio: NO_PROXY=localhost,127.0.0.1,.example.com

Variabili di installazione

VOLTA_LATEST_VERSION

Forza l'installatore di Volta a utilizzare una versione specifica invece dell'ultima versione.

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

VOLTA_TARGET_PROFILE

Specifica quale file di configurazione della shell l'installatore dovrebbe modificare.

• Valore predefinito: Rilevamento automatico basato sulla shell corrente
• Esempio: VOLTA_TARGET_PROFILE=$HOME/.bashrc

Variabili specifiche della piattaforma

VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK

Versione minima di Volta per il controllo di compatibilità nelle notifiche di aggiornamento.

• Esempio: VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK=1.0.5

Variabili specifiche di Windows

Queste variabili sono utilizzate solo sui sistemi Windows:

VOLTA_REDIRECT_STDERR

Quando impostata su 1, reindirizza l'output stderr a stdout su Windows.

• Valori validi: 0, 1
• Valore predefinito: 0

Utilizzo avanzato

VOLTA_UNSAFE_DIAGNOSTIC

Utilizzata per il debug; abilita diagnostiche avanzate che potrebbero essere instabili.

• Valori validi: Qualsiasi stringa
• Esempio: VOLTA_UNSAFE_DIAGNOSTIC=timing volta install node

VOLTA_STDIN_FILE_PASSTHROUGH

Quando impostata, Volta utilizzerà questo percorso di file invece di stdin per l'esecuzione degli script.

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

Esempi di configurazione

Ambiente di sviluppo

Per un setup di sviluppo con log dettagliati:

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

Pipeline CI/CD

Per ambienti di integrazione continua:

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

Rete aziendale

Per ambienti con server proxy:

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