Partager via


Utiliser des packages à partir de npmjs.com

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Le client npm est conçu pour fonctionner avec un registre principal (appelé flux dans Azure Artifacts) à la fois. Toutefois, il prend en charge des registres étendus supplémentaires. Si vous envisagez d’utiliser des packages privés et des packages publics à partir de npmjs.com, il est recommandé d’utiliser des sources en amont. Une fois que vous avez activé des sources en amont dans votre flux, Azure Artifacts enregistre automatiquement une copie de tout package installé dans votre flux. Cela offre la plus grande flexibilité, ce qui vous permet d’utiliser une combinaison de packages délimités et non étendus dans votre flux, y compris les packages délimités et non étendus de npmjs.com.

Prérequis

  • Une organisation et un projet Azure DevOps. Créez une organisation et un projet si vous ne l’avez pas déjà fait.

  • Un flux Azure Artifacts.

  • Téléchargez Node.js et npm.

Activer des sources en amont

Si vous n’avez pas encore créé de flux, procédez comme suit pour en créer un et veillez à cocher la case sources en amont pour les activer. Si vous disposez déjà d’un flux, passez à l’étape suivante pour ajouter npmjs en tant que source en amont.

  1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

  2. Sélectionnez Artifacts, puis sélectionnez Créer un flux.

  3. Fournissez un nom descriptif pour votre flux, définissez sa visibilité et son étendue. Cochez la case Sources en amont pour inclure des packages à partir de registres publics.

  4. Sélectionnez Créer lorsque vous avez terminé.

Ajouter npmjs en amont

Si vous avez coché les sources en amont lors de la création de votre flux, npmjs doit avoir été ajouté automatiquement. Si ce n’est pas le cas, vous pouvez l’ajouter manuellement comme suit :

  1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

  2. Sélectionnez Artefacts, puis sélectionnez votre flux.

  3. Sélectionnez le bouton d’engrenage icône d’engrenage d’icône d’engrenage pour accéder aux paramètres de flux.

  4. Sélectionnez Sources en amont, puis sélectionnez Ajouter en amont.

  5. Sélectionnez Source publique, puis npmjs (https://registry.npmjs.org/) dans le menu déroulant.

  6. Sélectionnez Ajouter lorsque vous avez terminé, puis sélectionnez Enregistrer dans le coin supérieur droit pour enregistrer vos modifications.

Installer des packages à partir de npmjs

Avant d’enregistrer des packages à partir de npmjs, vérifiez que votre projet est configuré pour vous connecter à votre flux. Si vous ne l’avez pas encore fait, suivez les instructions fournies pour configurer votre projet npm et vous connecter à votre flux. Dans cet exemple, nous allons installer la bibliothèque Axios pour effectuer des requêtes HTTP :

  1. Accédez à npmjs à l’adresse https://www.npmjs.com//.

  2. Recherchez le package Axios , puis sélectionnez-le pour accéder à la page de détails.

  3. Copiez la commande d’installation dans votre Presse-papiers.

  4. Dans une fenêtre d’invite de commandes, accédez au répertoire de votre projet et exécutez votre commande d’installation.

    npm install axios
    

Remarque

Pour enregistrer des packages à partir d’amont, vous devez disposer du rôle Flux et Lecteur en amont (Collaborateur) ou supérieur. Pour plus d’informations, consultez Gérer les autorisations .

Afficher les packages enregistrés

  1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

  2. Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.

  3. Sélectionnez npmjs dans le menu source. Le package Axios que nous avons installé précédemment est désormais disponible dans notre flux. Azure Artifacts a enregistré automatiquement une copie dans notre flux lors de l’exécution de la commande d’installation.

    Capture d’écran montrant le package axios enregistré en amont.