Publish npm packages with Azure Pipelines (YAML/Classic)

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

With Azure Pipelines, you can publish your npm packages to Azure Artifacts feeds and public registries like npmjs.com. This article will guide you through publishing your npm packages using both YAML and Classic pipelines.

Prerequisites

• An Azure DevOps organization. Create one for free.

• An Azure DevOps project. Create a new project if you don't have one already.

• An Azure Artifacts feed. Create one for free.

Publish to Azure Artifacts feeds

Note

To publish your packages to a feed using Azure Pipelines, ensure that both the Project Collection Build Service and your project's Build Service identity are configured as a Feed Publisher (Contributor). See Add new users/groups for more details.

YAML

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

• publishRegistry: select useFeed to use a feed within your organization. Options: useExternalRegistry, useFeed
• publishFeed: the feed you want to publish to. Required when publishRegistry = useFeed.

Tip

When adding the npm task to your YAML pipeline using the YAML editor, the project and feed IDs for your publishFeed will be generated automatically.

Classic

1. Navigate to the Azure DevOps portal, and then select your project.

2. Select Pipelines, and then select your pipeline definition.

3. Select Edit, and then select the + sign to add a new task. Search for the npm task, and then select Add to add it to your pipeline.

   

4. Name your task and then select Publish from the commands dropdown menu. Specify your package.json path, your Registry location, and your Target registry.

   • Working folder that contains package.json: path to the folder containing the target package.json and .npmrc files. Leave this blank if those files are at the root of your repo.
   • Registry location: select Registry I select here to publish to a feed.
   • Target registry: select your feed from the dropdown menu.

   

Publish to a public registry

Before publishing your packages to a public npm registry like npmjs.com, you must first create a service connection to authenticate with the desired external service.

1. Sign in to your Azure DevOps organization, and then navigate to your project.

2. Select Project settings > Service connections, and then select Create service connection.

   

3. Select npm and then select Next. Fill out the required fields, and then select Save when you're done.

YAML

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

• publishRegistry: select useExternalRegistry to publish to a public registry. Options: useExternalRegistry | useFeed.
• publishEndpoint: replace the placeholder with the name of the service connection you created earlier. required when publishRegistry == useExternalRegistry.

Classic

1. Navigate to the Azure DevOps portal, and then select your project.

2. Select Pipelines, and then select your pipeline definition.

3. Select Edit, and then select the + sign to add a new task. Search for the npm task, and then select Add to add it to your pipeline.

   

4. Name your task and then select Publish from the commands dropdown menu. Specify your package.json path, your Registry location, and your External registry.

   • Working folder that contains package.json: path to the folder containing the target package.json and .npmrc files. Leave this blank if those files are at the root of your repo.
   • Registry location: select External npm registry to publish to a public registry such as npmjs.com.
   • External registry: select the service connection you created earlier.

   

Related articles

• Publish and restore npm packages from the command line.
• Use packages from npmjs.com.
• Publish and download pipeline artifacts.