使用 Azure Pipelines 发布 npm 包（YAML/经典）

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

使用 Azure Pipelines，可以将 npm 包发布到 Azure Artifacts 源和公共注册表（例如 npmjs.com）。 本文将指导您使用 YAML 和经典管道发布 npm 包。

先决条件

• Azure DevOps 组织。 免费创建一个。

• 一个 Azure DevOps 项目。 如果您没有源，请创建一个新项目。

• Azure Artifacts 源。 免费创建一个。

发布到 Azure Artifacts 源

注意

若要使用 Azure Pipelines 将包发布到源，项目集合生成服务和项目的生成服务标识都必须配置为源发布者（参与者）。 有关更多详细信息，请参阅添加新用户/组。

YAML

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

• publishRegistry：选择 useFeed 以在组织中使用源。 选项：useExternalRegistry, useFeed
• publishFeed：要发布到的源。 当 publishRegistry 为 useFeed 时是必需的。

提示

使用 YAML 编辑器将 npm 任务添加到 YAML 管道时，将自动生成publishFeed项目和源 ID。

经典

1. 导航到 Azure DevOps 门户，然后选择项目。

2. 选择管道，然后选择您的管道定义。

3. 选择编辑，然后选择要添加新任务的 + 符号。 搜索npm任务，然后选择添加，将其添加到您的管道。

   

4. 为任务命名，然后从命令下拉菜单中选择发布。 指定 package.json 路径、注册表位置和目标注册表。

   • 包含 package.json 的工作文件夹：包含目标 package.json 和 .npmrc 文件的文件夹的路径。 如果这些文件位于存储库的根目录中，请将此留空。
   • 注册表位置：选择我在此处选择的注册表以发布到一个源。
   • 目标注册表：从下拉菜单中选择您的源。

   

发布到公共注册表

在将包发布到公共 npm 注册表（如 npmjs.com）之前，必须先创建服务连接以使用所需的外部服务进行身份验证。

1. 登录到 Azure DevOps 组织，并导航到你的项目。

2. 选择项目设置>服务连接，然后选择创建服务连接。

   

3. 依次选择“npm”、“下一步”。 填写必填字段，完成后选择保存。

YAML

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

• publishRegistry：选择 useExternalRegistry 以发布到公共注册表。 选项：useExternalRegistry |useFeed。
• publishEndpoint：将占位符替换为前面创建的服务连接的名称。 当 publishRegistry == useExternalRegistry 时必需。

经典

1. 导航到 Azure DevOps 门户，然后选择项目。

2. 选择管道，然后选择您的管道定义。

3. 选择编辑，然后选择要添加新任务的 + 符号。 搜索npm任务，然后选择添加，将其添加到您的管道。

   

4. 为任务命名，然后从命令下拉菜单中选择发布。 指定 package.json 路径、注册表位置和外部注册表。

   • 包含 package.json 的工作文件夹：包含目标 package.json 和 .npmrc 文件的文件夹的路径。 如果这些文件位于存储库的根目录中，请将此留空。
   • 注册表位置：选择外部 npm 注册表以发布到一个公共注册表，例如 npmjs.com。
   • 外部注册表：选择之前创建的服务连接。

   

相关文章

• 通过命令行发布并还原 npm 包。
• 使用来自 npmjs.com 的包。
• 发布和下载管道工件