Comprendre l'installation des dépendances avec npm ci

La commande npm ci est le moyen le plus sûr de veiller à ce que vos dépendances soient installées aux versions exactes répertoriées dans votre package-lock.json.

Qu'est-ce que le npm ci ?

Le npm ci est une commande du gestionnaire de paquet npm (Node Package Manager) utilisée pour installer des dépendances dans un environnement de développement. ci signifie "continuous integration" (intégration continue), ce qui montre que cette commande est particulièrement utile pour les scénarios d'intégration continue.

Le npm ci sert à installer les dépendances d'un projet Node.js. Ce qui le distingue de npm install traditionnel, c'est qu'il respecte strictement ce qui est défini dans votre fichier package-lock.json. Autrement dit, à chaque exécution de npm ci, vous obtiendrez exactement le même arbre de dépendances, garantissant ainsi congruence et fiabilité.

Pratique recommandée avec npm ci

Avec npm ci, vous pouvez créer un environnement de développement cohérent et fiable, évitant des erreurs inattendues dues à des différences dans les dépendances de version.

L'utilisation de npm ci au lieu du npm install est une pratique recommandée, surtout lors de l'exécution de votre code dans des environnements de production ou de test.

Exemple d'utilisation de npm ci

Un scénario d'utilisation typique pour npm ci pourrait être dans un environnement d'intégration continue. Lorsque votre outil d'intégration continue construit votre application, il devrait utiliser npm ci pour s'assurer qu'il utilise exactement les mêmes versions des dépendances que lors de votre dernier commit. Cela assure une cohérence entre les environnements et évite des problèmes potentiels liés à des différences de version de dépendance.

Par exemple, dans un fichier de configuration CircleCI, vous pourriez avoir une étape d'installation des dépendances comme suit :

version: 2
jobs:
  build:
    docker:
      - image: circleci/node:10
    steps:
      - checkout
      - run: npm ci
      - run: npm test

En bref, l'utilisation de npm ci peut grandement améliorer la stabilité et la cohérence de votre environnement de développement et de déploiement.