Azure Artifacts 中的 npm 包入门

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

使用 Azure Artifacts，可以从源和公共注册表（例如 npmjs.com）发布和下载 npm 包。 本快速入门将指导你通过 Azure Artifacts 源创建源、配置项目和管理 npm 包。

先决条件

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

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

• 下载并安装 Node.js 和 npm。

创建源

1. 登录到 Azure DevOps 组织，然后转到项目。

2. 选择“项目”，然后选择“创建源”。

3. 对于 “名称”，请输入源的描述性名称。

   对于 可见性，请选择一个选项来指示谁可以查看源中的包。

   如果要包含来自公共源的包，请选中上游源下的复选框。

   对于 范围，指定源的范围是项目还是组织。

4. 完成操作后，选择“创建”。

   

注意

默认情况下，新建的源的“生成服务”值设置为“源”和“上游读取者”（协作者）。

连接到源

注意

vsts-npm-auth 在 Azure DevOps Server 中不受支持。

Azure Artifacts 建议使用两个 .npmrc 文件。 第一个应放置在 $home 目录（Linux/macOS）或 $env中。HOME （Windows）用于安全地存储凭据。 这允许 npm 客户端找到该文件并检索凭据进行身份验证，使你能够在不公开凭据的情况下共享配置文件。 在本部分中，我们将设置第二个 .npmrc 文件，该文件应放置在package.json文件所在的同一目录中。

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

2. 选择 “项目”，然后选择“ 连接到源”。

3. 从左侧导航区域选择 npm 。 如果这是你第一次将 Azure Artifacts 与 npm 配合使用，请确保已安装必备组件。

4. 按照“项目设置”部分中的说明设置配置文件并连接到源。

   

重要

npm 支持 .npmrc 文件中的单个 registry 文件。 可以使用范围和上游源实现多个注册表。

发布包

在项目目录中运行以下命令，发布 npm 包：

npm publish

重要

不支持使用 publishConfig 属性在发布时重写注册表配置参数。

还原包

在项目目录中运行以下命令以还原 npm 包：

npm install

若要还原特定的 npm 包，请从项目目录运行以下命令：

npm install --save <PACKAGE_NAME>

相关文章

• 发布 npm 包（YAML/经典）
• 使用来自 npmjs.com 的包
• 使用 npm 范围