Utiliser des packages à partir du registre npm

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

Les sources en amont d’Azure Artifacts permettent aux développeurs d’utiliser des packages à partir de registres publics tels que npmjs.com. Une fois que les sources en amont sont activées dans votre flux, Azure Artifacts enregistre automatiquement une copie de tout package installé à partir d’une source en amont vers votre flux. Cette configuration offre la plus grande flexibilité, ce qui vous permet d’utiliser un mélange de packages délimités et non étendus, y compris ceux des registres publics, tous au sein d’un seul flux. Cette configuration garantit également un accès continu à ces packages, même si la source en amont devient temporairement indisponible.

Prérequis

Obtenir les outils

S’il s’agit de votre première utilisation d’Azure Artifacts avec npm sur votre machine, suivez les étapes ci-dessous pour configurer votre environnement :

npm install -g vsts-npm-auth --registry https://registry.npmjs.com --always-auth false

Créer un flux

Si vous disposez déjà d’un flux Azure Artifacts, passez à la section suivante. Sinon, créez-en un comme suit :

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

2. Sélectionnez Artefacts, puis créez un flux.

3. Entrez un nom pour votre flux, définissez la visibilité pour définir qui peut afficher vos packages, puis choisissez l’étendue du flux. Veillez à cocher la case Inclure des packages provenant de sources publiques courantes pour activer les sources en amont et autoriser la consommation de 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 est ajouté automatiquement à la liste des sources en amont dans votre flux. Si ce n’est pas le cas, vous pouvez l’ajouter manuellement comme suit :

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

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

3. Sélectionnez le bouton pour ouvrir les paramètres du 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 quand vous avez terminé.

7. Sélectionnez Enregistrer dans le coin supérieur droit pour appliquer vos modifications.

Se connecter à un flux

Avant de pouvoir commencer à enregistrer des packages à partir de sources en amont dans votre flux, vous devez d’abord configurer votre projet et vous connecter à votre flux.

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

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

3. Sélectionnez Se connecter au flux, puis sélectionnez npm dans le volet gauche.

4. Suivez les étapes décrites dans la section Configuration de Project pour configurer votre fichier .npmrc et vous authentifier auprès de votre flux. Pour plus d’informations, consultez configurer votre projet npm .

Installer des packages à partir de npmjs

Maintenant que vous avez authentifié avec votre flux, vous pouvez commencer à installer des packages à partir de registres publics tels que npmjs.com. Lorsque vous installez un package à partir d’une source en amont, Azure Artifacts enregistre automatiquement une copie de ce package dans votre flux. Dans cet exemple, vous allez installer Mongoose, une bibliothèque ODM (Object Data Modeling) MongoDB qui permet d’utiliser la définition de schéma, la validation des données et la modélisation d’objets dans Node.js applications.

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

2. Recherchez le package Mongoose , puis sélectionnez-le pour accéder à sa 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 la commande d’installation.

   npm i mongoose
   

Afficher les packages enregistrés

Maintenant que vous avez installé un package à partir du registre npm, vous pouvez voir comment Azure Artifacts enregistre automatiquement une copie de ce package dans votre flux. Procédez comme suit pour confirmer que le package a été ajouté à votre flux :

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

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

3. Dans le menu Source dans le coin supérieur droit, sélectionnez npmjs pour filtrer les packages à partir du registre npm.

4. Le package mongoose que vous avez installé à l’étape précédente doit maintenant apparaître dans votre flux. Azure Artifacts a enregistré automatiquement une copie lorsque vous avez exécuté la commande d’installation.

   

Contenu connexe

• Publier des packages npm (CLI)

• Publier des packages npm avec Azure Pipelines (YAML/Classic)

• Étendues Npm