Azure Artifacts 中的 npm 包入门

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

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

创建源

源是一种组织构造，允许用户存储其包并控制谁可以访问它们。 Azure Artifacts 支持将多个包类型存储在单个源中，例如 NuGet、npm、Maven、Python、Cargo 和通用包。

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

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

3. 输入源的描述性 名称 并定义其 可见性 （指示谁可以查看源中的包）。 指定源的范围，如果要包含来自公共源的包，请将上游源标记为检查框。

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

   

注意

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

设置 .npmrc 文件

注意

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

建议使用两个 .npmrc 文件。 第一个目录应与package.json文件位于同一目录中。 第二个应放置在 $home 目录（Linux/macOS）或 $env中。HOME （Windows）用于安全地存储凭据。 然后，npm 客户端将能够查找此文件并提取凭据进行身份验证。 这样，便可以在确保凭据安全的同时共享配置文件。

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

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

3. 从左侧导航窗格中选择 npm 。 如果这是第一次将 Azure Artifacts 与 npm 配合使用，请选择“ 获取工具 ”，然后按照步骤下载Node.js并设置计算机。

4. 将以下代码片段插入到 .npmrc 文件中，该文件位于package.json文件所在的同一目录中。 将占位符替换为相应的值。

   • 组织范围的源：

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

   • 项目范围的源：

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

设置凭据

重要

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

Windows

如果要在 Windows 上进行开发，建议使用 vsts-npm-auth 通过 Azure Artifacts 进行身份验证。 确保已从“获取工具”安装 vsts-npm-auth，然后运行 vsts-npm-auth，以获取添加到用户级别 npmrc 文件的 Azure Artifacts 令牌：

vsts-npm-auth -config .npmrc

其他

如果要在非 Windows 平台上进行开发，并且需要使用 Azure Artifacts 进行身份验证，则需要创建个人访问令牌，在 Base 64 中对其进行编码，然后将其添加到用户级 npmrc 文件。

1. 使用打包读取和写入范围生成个人访问令牌。

2. 按如下所示对新生成的个人访问令牌进行编码：

   1. 在命令提示符窗口中运行以下命令，对 PAT 进行编码：

      node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
      

   2. 粘贴个人访问令牌，然后按 Enter。

   3. 复制 Base 64 编码的个人访问令牌。

3. 将以下代码片段复制到用户级 .npmrc 文件，并将占位符替换为 [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] Base 64 个人访问令牌：

   • 组织范围的源：

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:username=[ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

   • 项目范围的源：

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

---

发布包

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

npm publish

重要

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

还原包

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

npm install --save <package>

若要还原所有 npm 包，请从项目目录运行以下命令：

npm install

相关文章

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