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

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é.

    Capture d’écran montrant les sélections pour la création d’un flux dans Azure DevOps Services.

  1. Connectez-vous à votre serveur 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.

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

    Capture d’écran montrant les sélections permettant de créer un flux dans Azure DevOps 2022.

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

    Capture d’écran montrant les sélections pour la création d’un flux dans Azure DevOps 2020.

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

  2. Sélectionnez Artefacts, puis nouveau 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, sélectionnez l’option Utiliser des packages à partir de sources publiques via cette option de flux .

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

    Capture d’écran montrant les sélections pour la création d’un flux dans Azure DevOps 2019.

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.

    Capture d’écran montrant comment configurer un projet npm et se connecter à un flux Azure Artifacts dans Azure DevOps Services.

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

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

  3. Sélectionnez npm à gauche, puis suivez les instructions de la section Configuration du projet pour vous connecter à votre flux.

    Capture d’écran montrant comment configurer un projet npm et se connecter à un flux Azure Artifacts dans Azure DevOps Server 2022.

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

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

  3. Sélectionnez npm à gauche, puis suivez les instructions de la configuration de Project pour configurer votre fichier de configuration et vous connecter à votre flux.

    Capture d’écran montrant comment configurer un projet npm et se connecter à un flux Azure Artifacts dans Azure DevOps Server 2020.

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

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

  3. Une nouvelle fenêtre s'affiche. Dans le volet de navigation gauche, sélectionnez npm et suivez les instructions pour configurer vos fichiers .npmrc et projet.

    Capture d’écran montrant comment configurer un projet npm et se connecter à un flux Azure Artifacts dans Azure DevOps Server 2019.

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>