Publier des packages npm avec Azure Pipelines (YAML/Classic)

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Avec Azure Pipelines, vous pouvez publier vos packages npm dans des flux Azure Artifacts ou des registres publics comme npmjs.com. Cet article vous guidera dans la publication de vos packages npm en utilisant les pipelines YAML et Classic.

Prérequis

• Une organisation Azure DevOps. Créez-en un gratuitement.

• Un projet Azure DevOps. Créez un nouveau projet si vous n'en avez pas déjà un.

• Un flux Azure Artifacts. Créez-en un gratuitement.

Publier dans des flux Azure Artifacts

Remarque

Pour publier vos packages dans un flux à l'aide d'Azure Pipelines, assurez-vous que le service de build de la collection de projets et l'identité du service de build de votre projet sont tous deux configurés en tant qu'éditeur de flux (contributeur). Pour obtenir des informations plus détaillées, consultez Ajouter de nouveaux utilisateurs/groupes.

YAML

- task: Npm@1
  inputs:
    command: publish
    publishRegistry: useFeed
    publishFeed: <FEED_NAME>        ## For project-scoped feeds, use: <PROJECT_NAME>/<FEED_NAME> 

• publishRegistry : sélectionnez useFeed pour utiliser un flux au sein de votre organisation. Options : useExternalRegistry, useFeed
• publishFeed : le flux sur lequel vous souhaitez publier. Obligatoire quand publishRegistry = useFeed.

Conseil

Lorsque vous ajoutez la tâche npm à votre pipeline YAML à l'aide de l'éditeur YAML, les ID de projet et de flux pour votre publishFeed seront générés automatiquement.

Classique

1. Accédez au portail Azure DevOps, puis sélectionnez votre projet.

2. Sélectionnez Pipelines, puis sélectionnez la définition de votre pipeline.

3. Sélectionnez Modifier, puis sélectionnez le signe + pour ajouter une nouvelle tâche. Recherchez la tâche npm, puis sélectionnez Ajouter pour l’ajouter à votre pipeline.

   

4. Nommez votre tâche, puis sélectionnez Publier dans le menu déroulant des commandes. Spécifiez votre chemin d'accès au package.json, l'emplacement de votre registre et votre registre cible.

   • Dossier de travail contenant package.json : Chemin du dossier contenant les fichiers package.json et .npmrc cibles. Laissez ce champ vide si ces fichiers se trouvent à la racine de votre dépôt.
   • Emplacement du Registre : Sélectionnez Registre que je sélectionne ici pour publier dans un flux.
   • Registre cible : sélectionnez votre flux dans le menu déroulant.

   

Publier dans un registre public

Avant de publier vos packages sur un registre npm public tel que npmjs.com, vous devez d'abord créer une connexion de service pour vous authentifier auprès du service externe souhaité.

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

2. Sélectionnez Paramètres du projet>Connexions de service, puis sélectionnez Créer une connexion de service.

   

3. Sélectionnez npm, puis sélectionnez Suivant. Remplissez les champs obligatoires, puis sélectionnez Enregistrer lorsque vous avez terminé.

YAML

- task: Npm@1
  inputs:
    command: publish
    publishRegistry: useExternalRegistry
    publishEndpoint: '<NAME_OF_YOUR_SERVICE_CONNECTION>'

• publishRegistry : Sélectionnez useExternalRegistry pour publier dans un registre public. Options : useExternalRegistry | useFeed.
• publishEndpoint : remplacez l'espace réservé par le nom de la connexion de service que vous avez créée précédemment. requis lorsque publishRegistry == useExternalRegistry.

Classique

1. Accédez au portail Azure DevOps, puis sélectionnez votre projet.

2. Sélectionnez Pipelines, puis sélectionnez la définition de votre pipeline.

3. Sélectionnez Modifier, puis sélectionnez le signe + pour ajouter une nouvelle tâche. Recherchez la tâche npm, puis sélectionnez Ajouter pour l’ajouter à votre pipeline.

   

4. Nommez votre tâche, puis sélectionnez Publier dans le menu déroulant des commandes. Spécifiez le chemin d’accès de votre package.json, l'emplacement de votre registre et votre registre externe.

   • Dossier de travail contenant package.json : Chemin du dossier contenant les fichiers package.json et .npmrc cibles. Laissez ce champ vide si ces fichiers se trouvent à la racine de votre dépôt.
   • Emplacement du Registre : Sélectionnez Registre npm externe pour publier dans un registre public comme npmjs.com.
   • Registre externe : sélectionnez la connexion de service que vous avez créée précédemment.

   

Articles connexes

• Publiez et restaurez des packages npm à partir de la ligne de commande.
• Utiliser des packages de npmjs.com
• Publier et télécharger les artefacts du pipeline.