通过

Azure Artifacts 中的 npm 包入门

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

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

先决条件

创建源

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

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

  3. 为您的源提供 名称，选择 可见性 选项来确定谁可以查看您的包。若要包括来自常见公共源（如 nuget.org 或 npmjs.com）的包，请勾选“包括公共源中的包”。关于 范围，请决定该源是否仅限于您的项目或整个组织。

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

    显示用于在 Azure DevOps Services 中创建新源的选择的屏幕截图。

  1. 登录到 Azure DevOps 服务器，然后转到项目。

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

  3. 为您的源提供 名称，选择 可见性 选项来确定谁可以查看您的包。若要包括来自常见公共源（如 nuget.org 或 npmjs.com）的包，请勾选“包括公共源中的包”。关于 范围，请决定该源是否仅限于您的项目或整个组织。

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

    显示用于在 Azure DevOps 2022 中创建新源的选择的屏幕截图。

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

    显示用于在 Azure DevOps 2020 中创建新源的选择的屏幕截图。

注意

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

连接到源

注意

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. 按照“项目设置”部分中的说明设置配置文件并连接到源。

    显示如何在 Azure DevOps Services 中设置 npm 项目并连接到 Azure Artifacts 源的屏幕截图。

  1. 登录到 Azure DevOps 集合，然后导航到项目。

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

  3. 从左侧选择 npm，然后按照“项目设置”部分中的说明连接到源。

    显示如何在 Azure DevOps Server 2022 中设置 npm 项目并连接到 Azure Artifacts 源的屏幕截图。

  1. 登录到 Azure DevOps 集合，然后导航到项目。

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

  3. 从左侧选择 npm，然后按照 Project 安装程序中的说明设置配置文件并连接到源。

    显示如何在 Azure DevOps Server 2020 中设置 npm 项目并连接到 Azure Artifacts 源的屏幕截图。

重要

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

发布包

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

npm publish

重要

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

还原包

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

npm install

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

npm install --save <PACKAGE_NAME>