Explorer
KNOW-PAT-207

Gestion des versions Node.js par projet avec nvm et .nvmrc

Domaine
devops
Type
pattern
Priorité
P2

Gestion des versions Node.js par projet avec nvm et .nvmrc

Problème

Différents projets nécessitent différentes versions de Node.js. Passer manuellement d'une version à l'autre est source d'erreurs et d'incompatibilités.

Solution

Utiliser un gestionnaire de versions (nvm) et un fichier .nvmrc à la racine du projet pour figer la version attendue, avec switch automatique au changement de répertoire.

Pourquoi c'est utile

  • Reproductibilité : tous les développeurs et CI utilisent la même version.
  • Switch automatique : configuration shell pour exécuter nvm use dans un dossier avec .nvmrc.
  • Isolation : versions globales et locales coexistent sans conflit.
  • CI/CD : le fichier .nvmrc peut être lu par les pipelines.

Quand l'appliquer

  • Équipe travaillant sur plusieurs projets Node.js.
  • CI/CD devant supporter plusieurs versions.
  • Besoin de compatibilité stricte avec la version runtime.

Quand NE PAS l'appliquer

  • Environnement unique avec une seule version de Node.js.
  • Utilisation de gestionnaire de packages global (volta, fnm) qui offre déjà cette fonctionnalité.

Références