Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Avec Azure Artifacts, vous pouvez publier et télécharger des packages npm à partir de vos propres flux et registres publics tels que npmjs.com. Ce guide de démarrage rapide vous guide tout au long de la création d’un flux, de la configuration de votre projet et de la gestion des packages npm à l’aide d’Azure Artifacts.
Prerequisites
| Produit | Exigences |
|---|---|
| Azure DevOps | - Une organisation Azure DevOps . - Un projet Azure DevOps . - Téléchargez et installez Node.js et npm. |
Créer un flux
Connectez-vous à votre organisation Azure DevOps et accédez à votre projet.
Sélectionnez Artifacts, puis sélectionnez Create feed.
Fournissez un nom pour votre flux, choisissez l’option Visibilité qui définit qui peut afficher vos packages, cochez Inclure des packages à partir de sources publiques courantes si vous souhaitez inclure des packages à partir de sources telles que nuget.org ou npmjs.com, et pour étendue, déterminez si le flux doit être étendu à votre projet ou à l’ensemble de l’organisation.
Sélectionnez Créer lorsque vous avez terminé.
Connectez-vous à votre serveur Azure DevOps et accédez à votre projet.
Sélectionnez Artifacts, puis sélectionnez Create feed.
Fournissez un nom pour votre flux, choisissez l’option Visibilité qui définit qui peut afficher vos packages, cochez Inclure des packages à partir de sources publiques courantes si vous souhaitez inclure des packages à partir de sources telles que nuget.org ou npmjs.com, et pour étendue, déterminez si le flux doit être étendu à votre projet ou à l’ensemble de l’organisation.
Sélectionnez Créer lorsque vous avez terminé.
Note
Par défaut, le service de build pour le projet (par exemple : projectName Build Service (orgName)) est affecté au rôle Flux et Lecteur en amont (Collaborateur) lorsqu’un flux est créé.
Se connecter à un flux
Azure Artifacts recommande d’utiliser deux fichiers de configuration distincts. La première doit être conservée localement 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 d’accéder à vos informations d’identification pour l’authentification.
Dans cette section, vous allez configurer le deuxième fichier npmrc , qui doit être placé dans le même répertoire que votre fichier package.json .
Cette configuration vous permet de partager votre fichier de configuration sans exposer vos informations d’identification.
Connectez-vous à votre organization Azure DevOps, puis accédez à votre projet.
Sélectionnez Artefacts, sélectionnez votre flux dans le menu déroulant, puis sélectionnez Se connecter au flux.
Dans le volet de navigation gauche, sélectionnez npm. S’il s’agit de votre première utilisation d’Azure Artifacts avec npm, vérifiez que vous avez installé les prérequis.
Dans la section Configuration du projet , sélectionnez Windows ou Autre en fonction de votre système d’exploitation, puis suivez les instructions fournies pour configurer votre fichier de configuration et vous connecter à votre flux Azure Artifacts.
Note
vsts-npm-auth n’est pas pris en charge dans Azure DevOps Server.
Connectez-vous à votre collection Azure DevOps puis accédez à votre projet.
Sélectionnez Artefacts, sélectionnez votre flux dans le menu déroulant, puis sélectionnez Se connecter au flux.
Dans le volet de navigation gauche, sélectionnez npm. S’il s’agit de votre première utilisation d’Azure Artifacts avec npm, vérifiez que vous avez installé les prérequis.
Dans la section Configuration du projet , sélectionnez Windows ou Autre en fonction de votre système d’exploitation, puis suivez les instructions fournies pour configurer votre fichier de configuration et vous connecter à votre flux Azure Artifacts.
Importante
Npm ne prend en charge qu’un seul registry paramètre dans votre fichier npmrc . Pour utiliser plusieurs registres, vous devez utiliser des sources amont ou des étendues.
Publier des packages dans votre flux
Pour exécuter correctement la commande de publication, vous devez d’abord vous authentifier auprès de votre flux. Si vous ne l’avez pas encore fait, suivez les étapes décrites dans la section Se connecter à un flux , puis suivez les instructions ci-dessous.
Dans le répertoire de votre projet, exécutez la commande suivante pour publier le package npm défini dans votre package.json:
npm publish
Importante
L’utilisation de la publishConfig propriété pour remplacer la configuration du Registre au moment de la publication n’est pas prise en charge.
Restaurer des packages à partir de votre flux
Pour exécuter correctement la commande restore, vous devez d’abord vous authentifier auprès de votre flux. Si vous ne l’avez pas encore fait, suivez les étapes décrites dans la section Se connecter à un flux , puis suivez les instructions ci-dessous.
Dans le répertoire de votre projet, exécutez la commande suivante pour restaurer tous les packages npm :
npm installPour restaurer un package npm spécifique, exécutez la commande suivante à partir du répertoire de votre projet :
npm install --save <PACKAGE_NAME>