Installateurs

Détails sur le fonctionnement des installateurs et comment créer vos propres installateurs/distributions personnalisés pour des installations hébergées.

Installateurs actuels

À partir de Volta 0.7.0, tous les installateurs officiels fonctionnent de la même manière :

1. Extraire les binaires Volta
2. Invoquer volta setup en utilisant le binaire volta extrait (voir volta setup pour plus d'informations)

Installateur Windows

L'installateur Windows extrait tous les binaires vers Program Files\Volta et ajoute ce dossier à la variable d'environnement système Path. Il créera également des shims dans ce répertoire pour les outils suivants :

• node
• npm
• npx
• yarn

Installateur Unix

L'installateur Unix extrait tous les binaires vers ~/.volta/bin, ils sont donc installés uniquement pour l'utilisateur spécifique.

Ignorer la configuration Volta

Si vous souhaitez exécuter l'installateur mais ne voulez pas que volta setup modifie vos scripts de profil de configuration, vous pouvez passer l'option --skip-setup à l'installateur :

curl https://get.volta.sh | bash -s -- --skip-setup

WARNING

Nous ne supportons actuellement pas l'ignorance de volta setup sur Windows.

Github CI

Pour votre commodité, nous fournissons une action Github personnalisée qui téléchargera automatiquement Volta, le mettra en cache, et téléchargera les outils des versions épinglées dans le package.json de votre projet.

Installation d'anciennes versions

Le script d'installateur par défaut fourni par get.volta.sh supporte uniquement l'installation de Volta 1.1.0 et plus récent. Si vous souhaitez installer une version plus ancienne, vous pouvez installer sur Unix en utilisant le script suivant, en remplaçant 1.0.8 par la version que vous voulez installer :

curl https://raw.githubusercontent.com/volta-cli/volta/8f2074f423c65405dfba9858d9bcf393c38ffb45/dev/unix/volta-install.sh | bash -s -- --version 1.0.8

Pour Windows, vous pouvez télécharger et installer le fichier .msi de l'installateur de version spécifique.

WARNING

Volta ne supporte pas la rétrogradation, donc pour rétrograder, vous devez complètement désinstaller Volta, puis installer la version inférieure.

Installateurs personnalisés

Pour créer une méthode d'installateur/distribution personnalisée, il y a deux étapes obligatoires et une étape optionnelle :

Distribuer les binaires

Les binaires eux-mêmes doivent être livrés à la machine cible. Le volta.manifest dans les fichiers de release listera les binaires nécessaires. À partir de Volta 0.7.0, les fichiers requis sont :

• volta[.exe]
• volta-shim[.exe]
• volta-migrate[.exe]

Tous ces binaires doivent être distribués dans le même répertoire, et ce répertoire doit être dans le PATH pour que les appels à la commande volta fonctionnent.

Répertoire des shims

Le répertoire des shims Volta doit également être ajouté au PATH pour que les shims fonctionnent également comme prévu. Le répertoire des shims est situé à $VOLTA_HOME/bin (%VOLTA_HOME%\bin sur Windows), où VOLTA_HOME est par défaut :

• ~/.volta sur Unix
• %LOCALAPPDATA%\Volta sur Windows

Les mises à jour du PATH peuvent être gérées manuellement si nécessaire, ou volta setup peut être invoqué (comme le font les installateurs officiels, comme mentionné ci-dessus).

Répertoire Volta personnalisé (optionnel)

Si vous souhaitez utiliser un répertoire différent de la VOLTA_HOME par défaut listée dans la section précédente pour les données Volta, vous devez définir la variable d'environnement VOLTA_HOME à ce répertoire. Si cette variable est définie, alors volta setup fonctionnera toujours correctement pour les répertoires de données personnalisés.