Comment configurer un Registre npm Privé, Distant et Virtuel

La manière la plus simple de gérer et d'organiser vos dépendances de Nœud consiste à utiliser un registre npm. Vous avez besoin d'un accès fiable, sécurisé, constant et efficace aux dépendances partagées au sein de votre équipe, le tout à un emplacement centralisé. Vous avez également besoin d'un endroit où configurer plusieurs dépôts, fonctionnant de manière fluide avec le client npm.

Grâce à l'abonnement Cloud gratuit de JFrog, qui comprend JFrog Artifactory, Xray et Pipelines, vous pouvez configurer gratuitement et en quelques minutes un registre npm local, distant et virtuel. Ce billet de blog va vous présenter les étapes à suivre.

Avant de commencer

Voici les éléments dont vous aurez besoin :

• Client npm installé
• Abonnement JFrog auto-hébergé ou abonnement JFrog Cloud
• JFrog CLI installé

Étape 1 : Connectez-vous à votre environnement

Connectez-vous avec le nom d'utilisateur par défaut : admin, et le mot de passe : password pour l'installation sur site, ou avec les identifiants qui vous ont été envoyés par email pour l'installation Cloud.

Étape 2 : Ajouter un registre npm local

Permet de stocker le npm personnalisé que vous allez créer ultérieurement. Accédez au Module Administration. Développez le menu Dépôts (Repositories) et cliquez sur l'élément de menu Dépôts (Repositories).

Ajoutez un nouveau Dépôt Local avec le type de package npm. Entrez la Clé de Dépôt « npm-challenge-local » et conservez les autres paramètres par défaut.

Étape 3 : Ajouter un registre npm distant

Utilisé en tant que proxy de mise en cache, pour stocker un tiers à partir de https://registry.npmjs.org

Cliquez sur l'onglet Distant (Remote) sur la page Dépôts (Repositories) et ajoutez un nouveau Dépôt Distant avec le type de package Npm. Entrez la Clé de Dépôt « npm-challenge-remote » et conservez les autres paramètres par défaut.

Étape 4 : Ajouter un registre npm virtuel

Cliquez sur l'onglet Virtuel (Virtual) sur la page Dépôts (Repositories) et ajoutez un nouveau Dépôt Virtuel avec le type de package npm.

Entrez la Clé de Dépôt « npm » et ajoutez le registre npm local et distant que vous avez créé aux Étapes 2 et 3 (déplacez-les depuis Dépôts Disponibles (Available Repositories) vers Dépôts sélectionnés (Selected Repositories) à l'aide des boutons fléchés). L'ordre de ces dépôts dans la liste déterminera l'ordre suivi pour résoudre les dépendances requises pour l'assemblage de votre package npm.

Sélectionnez le dépôt local que vous avez créé à l'Étape 2 en tant que Dépôt de Déploiement par Défaut. Le Dépôt de Déploiement par Défaut est le dépôt vers lequel seront envoyées les dépendances npm que vous assemblez. Conservez les autres paramètres par défaut.

Étape 5 : Dupliquez le dépôt GitHub d'exemple npm JFrog

Ce dépôt contient un exemple npm simple que vous allez utiliser pour assembler votre projet.

Étape 6 : Configurer JFrog CLI

Configurez JFrog CLI, un client intelligent qui fournit une interface simple automatisant l'accès aux produits JFrog, ce qui simplifie nos scripts d'automatisation.

• Configurez le serveur Artifactory.

  $ jfrog rt c

  

• Suivez les étapes ci-dessous pour assembler le projet avec npm et résoudre les dépendances du projet à partir d'Artifactory.
  • Accédez au répertoire racine du projet
  • Configurez les dépôts du projet.

    $ jfrog rt npmc
    
    

  • Installer le package npm

    $ jfrog rt npm-install --build-name=my-npm-build --build-number=1

  • Ajoutez des variables d'environnement aux informations du build.

    $ jfrog rt bce my-npm-build 1

  • Mettez en pack et publiez le package npm dans Artifactory, tout en l'enregistrant en tant qu'artefact dans les informations du build.

    $ jfrog rt npm-publish --build-name=my-npm-build --build-number=1

  • Publiez les informations du build dans Artifactory.

    $ jfrog rt bp my-npm-build 1

Étape 7 : Consulter votre dépôt

Accédez au Module de l'application, dans l'interface utilisateur de la plateforme, développez le menu Artifactory et cliquez sur l'élément de menu Artefacts (Artifacts. Vous pourrez voir ici les détails de vos nouveaux artefacts.

Votre registre npm

Lorsque vous aurez terminé et configuré votre registre Npm, vous pourrez stocker toutes vos dépendances dans vos dépôts locaux, distants et virtuels. Voici à quoi cela ressemblera :

C'est tout !

Maintenant, il ne vous reste plus qu'à faire vos propres essais.