Épingler les versions Node

L'une des fonctionnalités les plus puissantes de Volta est la capacité d'épingler des versions d'outils spécifiques à votre projet, garantissant que tous ceux qui travaillent sur le projet utilisent exactement la même chaîne d'outils.

Pourquoi épingler les versions ?

• Cohérence : Tout le monde dans votre équipe utilise les mêmes versions
• Reproductibilité : Les environnements de build correspondent aux environnements de développement
• Fiabilité : Pas de surprises dues à un comportement d'outil inattendu
• Intégration : Les nouveaux membres de l'équipe obtiennent automatiquement la bonne configuration

Comment épingler Node.js

Pour épingler une version spécifique de Node.js à votre projet :

volta pin node@16.14.2

Cette commande :

1. Télécharge et installe Node.js 16.14.2 (s'il n'est pas déjà présent)
2. Met à jour votre package.json avec une section volta
3. Fait que le projet utilise Node.js 16.14.2 quand vous exécutez node dans le répertoire du projet

Votre package.json contiendra maintenant :

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

Épingler les gestionnaires de paquets

Vous pouvez également épingler des versions spécifiques de gestionnaires de paquets :

volta pin npm@8.5.0
volta pin yarn@1.22.18
volta pin pnpm@7.0.0

Cela garantit que tout le monde utilise la même version du gestionnaire de paquets, prévenant les incohérences de fichiers de verrous et autres problèmes de versions.

Après avoir épinglé npm, votre package.json ressemblera à ceci :

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

Utiliser les outils épinglés

Une fois que les outils sont épinglés, aucune commande supplémentaire n'est nécessaire. Naviguez simplement vers le répertoire de votre projet et exécutez les commandes normalement :

# Ceux-ci utiliseront les versions épinglées de votre projet
node --version
npm --version

Volta détecte automatiquement quand vous êtes dans un répertoire avec des versions épinglées et les utilise au lieu de vos outils par défaut.

Mettre à jour les versions épinglées

Pour mettre à jour les versions épinglées :

volta pin node@latest
volta pin npm@latest

Ou spécifier de nouvelles versions :

volta pin node@18

Meilleures pratiques

Quand épingler

• Pour les applications de production : Épinglez toujours Node et votre gestionnaire de paquets
• Pour les bibliothèques/paquets : Épinglez Node si votre code dépend de fonctionnalités spécifiques de Node
• Pour les outils/utilitaires : Épinglez la version Node minimale requise pour la fonctionnalité

Sélection de version

• Pour les applications, choisissez des versions LTS (Support Long Terme) de Node
• Pour les bibliothèques, utilisez la version Node la plus ancienne que vous voulez supporter
• Mettez à jour régulièrement les versions pour bénéficier des correctifs de sécurité

Intégration CI/CD

Assurez-vous que vos pipelines CI/CD respectent vos versions épinglées :

• Utilisez l'Action GitHub Volta dans les workflows GitHub
• Pour d'autres systèmes CI, installez Volta et il utilisera automatiquement vos versions épinglées