Partager via


Se connecter à un flux Azure Artifacts - npm

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

Azure Artifacts permet aux développeurs de gérer des packages à partir de différentes sources, notamment des registres publics tels que des npmjs.com et des flux privés. Pour vous authentifier auprès d’Azure Artifacts, vous devez configurer votre fichier de configuration .npmrc . Ce fichier stocke les URL de flux et les informations d’identification utilisées par npm, et vous permet de personnaliser le comportement du client, comme la configuration des proxys, la définition des emplacements de package par défaut ou la configuration de l’accès aux flux privés. Le fichier .npmrc se trouve généralement dans le répertoire de base de l’utilisateur, mais peut également être créé au niveau du projet pour remplacer les paramètres par défaut.

Conditions préalables

Produit Exigences
Azure DevOps - Une organisation Azure DevOps .
- Un projet Azure DevOps .
- Un flux Azure Artifacts
- Téléchargez et installez Node.js et npm.

Se connecter à un flux

Azure Artifacts recommande d’utiliser deux fichiers de configuration .npmrc distincts. Il doit être stocké localement pour stocker vos informations d’identification, tandis que l’autre doit être ajouté à votre répertoire de projet en même temps que votrepackage.json pour définir votre URL de flux. Cette approche vous permet de partager votre configuration au niveau du projet sans exposer d’informations sensibles.

Pour configurer le fichier d’informations d’identification, créez ou mettez à jour le fichier .npmrc et incluez toutes les informations d’identification de Registre nécessaires. Cela permet au client npm d’accéder facilement à vos informations d’identification pour l’authentification.

Les étapes suivantes vous guident tout au long de la configuration du fichier de configuration au niveau du projet. Sélectionnez l’onglet correspondant à votre environnement de développement :

Remarque

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

  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 Se connecter au flux , puis sélectionnez npm dans le volet de navigation gauche.

  4. Ajoutez un fichier .npmrc à votre projet, dans le même répertoire que votre package.json et collez l’extrait de code fourni à partir de la section d’installation du projet dans le fichier.

    Capture d’écran montrant comment configurer votre projet npm et se connecter à un flux.

  5. Exécutez la commande suivante pour obtenir un jeton Azure Artifacts ajouté à votre fichier .npmrc au niveau de l’utilisateur. Vous n’avez pas besoin de l’exécuter à chaque fois : npm retourne une erreur 401 non autorisée lorsqu’il est temps d’actualiser le jeton.

    vsts-npm-auth -config .npmrc
    
  1. Connectez-vous à votre collection Azure DevOps, puis accédez à votre projet.

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

    Capture d’écran montrant comment se connecter à un flux dans Azure DevOps Server 2022.1.

  3. Sélectionnez npm à gauche, puis suivez les étapes décrites dans la section d’installation de Project pour configurer votre fichier .npmrc. et vous authentifier avec votre flux.

    Capture d’écran montrant comment configurer votre projet npm dans Azure DevOps Server 2022.1.

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

  2. Sélectionnez Artefacts, puis sélectionnez Se connecter au flux.

    Capture d’écran montrant comment se connecter à un flux dans Azure DevOps Server 2020.1.

  3. Sélectionnez npm à gauche, puis suivez les étapes décrites dans la section d’installation de Project pour configurer votre fichier .npmrc. et vous authentifier avec votre flux.

    Capture d’écran montrant comment configurer votre projet npm dans Azure DevOps Server 2020.1.

Conseil

L'utilisation de plusieurs registres dans les fichiers .npmrc est possible grâce à des espaces de nommage et des sources en amont.