Node Version Manager (NVM) est un outil indispensable pour les développeurs Node.js qui basculent fréquemment entre différentes versions de Node.js pour divers projets. Que vous mainteniez des applications existantes, que vous expérimentiez les dernières fonctionnalités ou que vous ayez simplement besoin d'une version différente pour différents projets, NVM peut vous simplifier la vie. Dans ce blog, nous approfondirons NVM, en explorant les techniques avancées et les meilleures pratiques pour gérer efficacement les versions de Node.js.

Pourquoi utiliser NVM ?

Avant d'aborder l'utilisation avancée de NVM, récapitulons rapidement pourquoi vous devriez l'utiliser :

1. Gestion des versions : basculez facilement entre plusieurs versions de Node.js.
2. Isolement de l'environnement : assurez-vous que chaque projet utilise sa version Node.js requise sans conflits.
3. Commodité : simplifiez l'installation et la mise à jour des versions de Node.js.

Installation de la NVM

Pour les systèmes basés sur Unix (Linux/macOS)

Pour démarrer avec NVM sur les systèmes Unix, vous devez l'installer. Le processus d'installation est simple :

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.4/install.sh | bash

Après avoir exécuté le script, ajoutez les lignes suivantes à votre fichier .bashrc, .zshrc ou .profile :

export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

Rechargez la configuration de votre shell :

source ~/.bashrc  # or ~/.zshrc, ~/.profile depending on your shell

Pour les fenêtres

Pour Windows, vous pouvez utiliser nvm-windows, un outil similaire conçu pour les environnements Windows.

1. Téléchargez le programme d'installation à partir du référentiel nvm-windows.
2. Exécutez le programme d'installation et suivez les instructions à l'écran.

Après l'installation, ouvrez une nouvelle invite de commande et vérifiez l'installation :

nvm version

Utilisation de base

Une fois NVM installé, abordons quelques commandes de base :

Installation des versions de Node.js

Vous pouvez installer n'importe quelle version de Node.js en la spécifiant :

nvm install 14.20.1  # Install Node.js 14.20.1
nvm install 18.0.0   # Install Node.js 18.0.0

Liste des versions installées

Pour voir toutes les versions de Node.js installées :

nvm ls

Utiliser une version spécifique

Passez à une version spécifique pour votre session en cours :

nvm use 14.20.1

Définition d'une version par défaut

Définissez une version Node.js par défaut à utiliser dans tous les nouveaux shells :

nvm alias default 14.20.1

Utilisation avancée de NVM

Maintenant que vous connaissez les bases, explorons les techniques NVM avancées.

Travailler avec des fichiers .nvmrc

Un fichier .nvmrc peut spécifier la version Node.js d'un projet. Créez un fichier .nvmrc dans le répertoire racine de votre projet contenant la version Node.js souhaitée :

14.20.1

Lorsque vous accédez au répertoire du projet, utilisez la commande suivante pour passer à la version spécifiée :

nvm use

Vous pouvez automatiser ce processus avec une fonction shell qui charge automatiquement la version lorsque vous entrez dans le répertoire :

# Add this to your .bashrc or .zshrc
autoload -U add-zsh-hook
load-nvmrc() {
  if [[ -f .nvmrc ]]; then
    nvm use
  fi
}
add-zsh-hook chpwd load-nvmrc
load-nvmrc

Installation de variantes Node.js spécifiques

NVM vous permet d'installer différentes variantes de Node.js, telles que io.js ou différentes versions LTS :

nvm install iojs
nvm install --lts

Vérification des nouvelles versions

Gardez vos versions de Node.js à jour avec :

nvm ls-remote

Cette commande répertorie toutes les versions de Node.js disponibles, vous permettant de voir si une nouvelle version a été publiée.

Désinstallation des versions de Node.js

Supprimez les versions Node.js inutilisées pour libérer de l'espace :

nvm uninstall 14.20.1

Automatisation des scripts

Pour l'automatisation et les pipelines CI/CD, vous pouvez utiliser NVM dans les scripts. Voici un exemple d'utilisation de NVM dans un script bash :

#!/bin/bash

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

nvm install 14.20.1
nvm use 14.20.1

node -v

Gestion des packages globaux

Les packages globaux sont installés par version de Node.js. Pour gérer cela efficacement, utilisez la commande reinstall-packages de nvm :

nvm install 18.0.0
nvm reinstall-packages 14.20.1

Cette commande réinstalle tous les packages globaux de la version 14.20.1 à 18.0.0.

Utilisation avec Docker

Pour les projets utilisant Docker, vous pouvez rationaliser vos fichiers Docker en utilisant NVM pour installer Node.js :

FROM ubuntu:20.04

# Install dependencies
RUN apt-get update && apt-get install -y curl

# Install NVM
RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.4/install.sh | bash

# Set up NVM environment
ENV NVM_DIR /root/.nvm
ENV NODE_VERSION 14.20.1
RUN . $NVM_DIR/nvm.sh && nvm install $NODE_VERSION

# Ensure Node.js is available
ENV PATH $NVM_DIR/versions/node/v$NODE_VERSION/bin:$PATH

# Verify installation
RUN node -v

Dépannage et conseils

Problèmes courants

1. Commande NVM introuvable : assurez-vous que vos fichiers de configuration shell proviennent correctement de NVM.
2. Problèmes d'autorisation : exécutez des commandes avec les autorisations appropriées ou ajustez le chemin d'installation de votre NVM.

Les meilleures pratiques

1. Mettre régulièrement à jour NVM : gardez NVM lui-même à jour pour bénéficier de nouvelles fonctionnalités et de corrections de bugs.
2. Utiliser les fichiers .nvmrc : cela garantit la cohérence entre les environnements de développement et les pipelines CI.
3. Gestion globale des packages : synchronisez régulièrement les packages globaux entre les versions de Node.js pour maintenir la cohérence.

Conclusion

NVM est un outil puissant qui peut rationaliser considérablement votre flux de travail de développement Node.js. En maîtrisant NVM, vous pouvez gérer sans effort plusieurs versions de Node.js, garantir la compatibilité des projets et maintenir un environnement de développement propre. Que vous soyez un développeur chevronné ou que vous débutiez tout juste avec Node.js, l'intégration de NVM dans votre boîte à outils améliorera votre productivité et votre flexibilité.

Bon codage !