Prise en main des packages npm dans Azure Artifacts

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

À l’aide d’Azure Artifacts, vous pouvez publier et télécharger vos packages npm à partir de flux et de registres publics tels que npmjs.com. Ce guide de démarrage rapide vous guide tout au long de la création de votre flux, de la configuration de votre projet et de la gestion des packages npm avec votre flux Azure Artifacts.

Prérequis

• Une organisation Azure DevOps. Créez-en un gratuitement.

• Un projet Azure DevOps. Créez un nouveau projet si vous n'en avez pas déjà un.

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

Créer un flux

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

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

3. Pour Nom, entrez un nom descriptif pour votre flux.

   Pour visibilité, sélectionnez une option pour indiquer qui peut afficher les packages dans le flux.

   Si vous souhaitez inclure des packages à partir de sources publiques, cochez la case sous Sources en amont.

   Pour Étendue, spécifiez si l’étendue de votre flux est le projet ou l’organisation.

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

   

Remarque

Par défaut, les flux nouvellement créés ont la valeur du service de build de leur projet définie sur Feed and Upstream Reader (Collaborateur).

Se connecter à un flux

Remarque

vsts-npm-auth n’est pas pris en charge dans Azure DevOps Server.

Azure Artifacts recommande d’utiliser deux fichiers .npmrc. Le premier doit être placé dans le répertoire $home (Linux/macOS) ou $env. HOME (Windows) pour stocker en toute sécurité vos informations d’identification. Cela permet au client npm de localiser le fichier et de récupérer vos informations d’identification pour l’authentification, ce qui vous permet de partager votre fichier de configuration sans exposer vos informations d’identification. Dans cette section, nous allons configurer le deuxième fichier .npmrc , qui doit être placé dans le même répertoire que votre fichier package.json .

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

2. Sélectionnez Artefacts, puis connectez-vous au flux.

3. Sélectionnez npm dans la zone de navigation de gauche. S’il s’agit de votre première utilisation d’Azure Artifacts avec npm, vérifiez que vous avez installé les prérequis.

4. Suivez les instructions de la section Configuration de Project pour configurer votre fichier de configuration et vous connecter à votre flux.

   

Important

npm prend en charge un seul registry fichier .npmrc. Plusieurs registres sont possibles avec des étendues et des sources en amont.

Publier des packages

Exécutez la commande suivante dans votre répertoire de projet pour publier vos packages npm :

npm publish

Important

L’utilisation de la publishConfig propriété pour remplacer l’analyseur de configuration du Registre au moment de la publication n’est pas prise en charge.

Restaurer des packages

Exécutez la commande suivante dans le répertoire de votre projet pour restaurer vos packages npm :

npm install

Pour restaurer un package npm spécifique, exécutez la commande suivante à partir du répertoire de votre projet :

npm install --save <PACKAGE_NAME>

Articles connexes

• Publier des packages npm (YAML/Classic)
• Utiliser des packages à partir de npmjs.com
• Utiliser des étendues npm