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 des packages npm à partir de flux et de registres publics comme npmjs.com. Ce guide de démarrage rapide vous guide tout au long du processus de création de votre flux, de configuration de votre projet et de publication et de téléchargement de packages npm vers et à partir de votre flux Azure Artifacts.

Créer un flux

Un flux est une construction organisationnelle qui permet aux utilisateurs de stocker leurs packages et de contrôler qui peut y accéder. Azure Artifacts prend en charge le stockage de plusieurs types de packages dans un seul flux, tel que NuGet, npm, Maven, Python, Cargo et universal.

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

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

3. Entrez un nom descriptif pour votre flux et définissez sa visibilité (indiquant qui peut afficher les packages dans le flux). Spécifiez l’étendue de votre flux et, si vous souhaitez inclure des packages à partir de sources publiques, marquez les sources en amont case activée box.

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

   

Remarque

Par défaut, les flux nouvellement créés ont le service de génération de leur projet défini sur Feed and Upstream Reader (Collaborateur).

Configurer vos fichiers .npmrc

Remarque

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

Nous vous recommandons d’utiliser deux fichiers .npmrc. Le premier doit se trouver dans le même répertoire que votre fichier package.json. La deuxième doit être placée dans le répertoire $home (Linux/macOS) ou $env. HOME (Windows) pour stocker en toute sécurité vos informations d’identification. Le client npm pourra ensuite rechercher ce fichier et récupérer vos informations d’identification pour l’authentification. Cela vous permet de partager votre fichier de configuration tout en conservant vos informations d’identification sécurisées.

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

2. Sélectionnez Artefacts, puis sélectionnez Connecter à alimenter.

3. Sélectionnez npm dans le volet de navigation gauche. S’il s’agit de votre première utilisation d’Azure Artifacts avec npm, sélectionnez Obtenir les outils et suivez les étapes pour télécharger Node.js et configurer votre machine.

4. Insérez l’extrait de code suivant dans votre fichier .npmrc, celui situé dans le même répertoire que votre fichier package.json. Remplacez les espaces réservés par les valeurs appropriées.

   • Flux d’étendue de l’organisation :

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

   • Flux dans l’étendue du projet :

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

Configurer les informations d’identification

Important

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

Windows

Si vous développez sur Windows, nous vous recommandons d’utiliser vsts-npm-auth pour vous authentifier auprès d’Azure Artifacts. Vérifiez que vous avez installé vsts-npm-auth à partir d’Obtenir les outils , puis exécutez vsts-npm-auth pour obtenir un jeton Azure Artifacts ajouté à votre fichier npmrc de niveau utilisateur :

vsts-npm-auth -config .npmrc

Autres

Si vous développez sur une plateforme non-Windows et que vous devez vous authentifier auprès d’Azure Artifacts, vous devez créer un jeton d’accès personnel, l’encoder en Base 64, puis l’ajouter à votre fichier npmrc au niveau de l’utilisateur.

1. Générez un jeton d’accès personnel avec des étendues de lecture et d’écriture d’empaquetage.

2. Encoder votre jeton d’accès personnel nouvellement généré comme suit :

   1. Exécutez la commande suivante dans une fenêtre d’invite de commandes pour encoder votre PAT :

      node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
      

   2. Collez votre jeton d’accès personnel, puis appuyez sur Entrée.

   3. Copiez le jeton d’accès personnel codé en base 64.

3. Copiez l’extrait de code suivant dans votre fichier .npmrc de niveau utilisateur et remplacez l’espace [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] réservé par votre jeton d’accès personnel Base 64 :

   • Flux d’étendue de l’organisation :

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:username=[ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

   • Flux dans l’étendue du projet :

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

---

Publier des packages

Pour publier votre package npm, exécutez la commande suivante dans le répertoire de votre projet :

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

Pour restaurer un package npm, exécutez la commande suivante dans le répertoire de votre projet :

npm install --save <package>

Pour restaurer tous vos packages npm, exécutez la commande suivante à partir du répertoire de votre projet :

npm install

Articles connexes

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