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
Azure Artifacts permet aux développeurs de publier et de télécharger des packages npm à partir de flux ou de registres publics.
Cet article vous guide tout au long de la création d’un flux, de la configuration de votre projet et de la publication et du téléchargement de packages npm.
Prerequisites
- 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.
Entrez un nom pour votre flux.
Choisissez un paramètre de visibilité pour contrôler qui peut afficher les packages dans le flux.
Sélectionnez Inclure des packages à partir de sources publiques courantes si vous souhaitez que votre flux utilise des packages en amont à partir de sources telles que nuget.org ou npmjs.com.
Pour Étendue, choisissez si le flux est limité au projet actuel 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.
Entrez un nom pour votre flux.
Choisissez un paramètre de visibilité pour contrôler qui peut afficher les packages dans le flux.
Sélectionnez Inclure des packages à partir de sources publiques courantes si vous souhaitez que votre flux utilise des packages en amont à partir de sources telles que nuget.org ou npmjs.com.
Pour Étendue, choisissez si le flux est limité au projet actuel ou à l’ensemble de l’organisation.
Sélectionnez Créer lorsque vous avez terminé.
Note
Lorsque vous créez un flux, le compte de service de génération du projet, tel que projectName Build Service (orgName) est affecté par défaut au rôle Flux et Lecteur en amont (Collaborateur).
Configurer l’authentification npm
Avant de vous connecter à un flux, configurez l’authentification pour le client npm sur votre ordinateur. Les étapes diffèrent selon votre système d’exploitation :
Windows
Installezvsts-npm-auth, qui génère et actualise les informations d’identification que npm utilise pour vous connecter à votre flux de Azure Artifacts.
npm install -g vsts-npm-auth --registry https://registry.npmjs.com
macOS et Linux
vsts-npm-auth n’est pas pris en charge sur macOS ou Linux. Au lieu de cela, créez un jeton d’accès personnel (PAT) avec l’étenduede lecture et d’écritured’empaquetage>. Utilisez ce PAT lorsque vous configurez votre fichier .npmrc utilisateur dans la section suivante.
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.
À l’aide de cette configuration, vous pouvez partager la configuration du projet avec votre équipe sans exposer d’informations d’identification dans le contrôle de code source. Pour plus d’informations, consultez Se connecter à un flux de Azure Artifacts - npm.
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.
Sélectionnez npm dans le volet de navigation gauche.
Sous Project configuration, sélectionnez Windows ou Autre pour votre système d’exploitation, puis suivez les instructions fournies pour mettre à jour vos fichiers .npmrc de niveau utilisateur et de project niveau utilisateur.
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.
Sélectionnez npm dans le volet de navigation gauche.
Sous Project configuration, sélectionnez Windows ou Autre pour votre système d’exploitation, puis suivez les instructions fournies pour mettre à jour vos fichiers .npmrc de niveau utilisateur et de project niveau utilisateur.
Importante
npm ne prend en charge qu’un seul registry paramètre dans votre fichier .npmrc . Si vous avez besoin de paquets provenant de plusieurs sources, utilisez des sources en amont or scopes au lieu d'ajouter plusieurs entrées registry.
Publier des packages dans votre flux
Note
Pour publier des packages dans un flux, vous devez être un éditeur de flux (contributeur) ou plus. Consultez la section Gérer les permissions pour plus de détails.
Avant de publier des packages, veillez à 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 de la section suivante.
Dans le répertoire de votre projet, exécutez la commande suivante pour publier le package défini dans votre fichier dans votre
package.jsonflux :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
Avant de restaurer des packages, veillez à vous authentifier auprès de votre flux et à mettre à jour les fichiers .npmrc pour votre projet. Si vous ne l’avez pas encore fait, effectuez les étapes de connexion à un flux, puis continuez.
Dans le répertoire de votre projet, exécutez la commande suivante pour restaurer tous les packages répertoriés dans votre
package.jsonfichier :npm installPour installer un package spécifique à partir du flux et l’ajouter en tant que dépendance dans votre
package.jsonfichier, exécutez la commande suivante :npm install --save <PACKAGE_NAME>