volta pin

La commande volta pin mettra à jour le fichier package.json de votre projet pour utiliser la version sélectionnée des outils. Elle a la syntaxe suivante :

Épingler le runtime ou gestionnaire de paquets de votre projet

Usage :
    volta pin [FLAGS] <tool[@version]>...

Drapeaux :
        --verbose    Activer les diagnostics détaillés
        --quiet      Empêcher les sorties inutiles
    -h, --help       Imprimer les informations d'aide

Arguments :
    <tool[@version]>...    Les outils à épingler, tels que `node@lts` ou `yarn@^1.14`.

Notevolta pin ne fonctionne que pour Node et les gestionnaires de paquets (par exemple npm ou Yarn). Pour les dépendances, vous devriez utiliser npm install ou yarn add pour mettre à jour la version sélectionnée.

Exemples

Épingler Node.js

# Épingler la dernière version LTS de Node
volta pin node

# Épingler une version spécifique de Node
volta pin node@16.14.2

# Épingler une plage de versions Node
volta pin node@16

Quand vous épinglez une version Node.js, Volta ajoute une section volta au fichier package.json de votre projet :

{
  "volta": {
    "node": "16.14.2"
  }
}

Épingler des gestionnaires de paquets

# Épingler la dernière version de npm
volta pin npm

# Épingler une version spécifique de Yarn
volta pin yarn@1.22.19

# Épingler pnpm (si le drapeau de fonctionnalité est activé)
VOLTA_FEATURE_PNPM=1 volta pin pnpm@7.0.0

Épingler des gestionnaires de paquets les ajoute à la section volta dans package.json :

{
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0"
  }
}

Cas d'utilisation

La commande volta pin est cruciale pour :

• Créer des environnements de développement cohérents à travers votre équipe
• S'assurer que tout le monde travaillant sur le projet utilise la même version de Node.js et gestionnaire de paquets
• Prévenir les problèmes "ça marche sur ma machine"
• Documenter avec quelle version de Node.js votre projet est compatible

Effets de l'épinglage

Quand vous épinglez des outils :

1. L'outil est automatiquement installé si vous ne l'avez pas déjà
2. La version est écrite dans la section volta de package.json
3. Toute personne utilisant Volta travaillant sur le projet utilisera automatiquement la version spécifiée
4. Les systèmes CI/CD utilisant Volta utiliseront la bonne version

Les outils épinglés ont priorité sur les versions d'outils par défaut définies avec volta install.

Détails package.json

La section volta dans package.json peut inclure :

{
  "volta": {
    "node": "16.14.2",    // Version exacte
    "npm": "^8.5.0",      // Plage Semver
    "yarn": "1.22.19",    // Version exacte
    "pnpm": "7.0.0"       // Si le support pnpm est activé
  }
}

Les spécificateurs de version peuvent être :

• Version exacte : 16.14.2
• Version majeure : 16
• Version majeure.mineure : 16.14
• Plage Semver : ^16.14.0
• Tags : lts, latest