使用 Azure Pipelines 还原 NuGet 包

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

使用 NuGet 包还原可以安装项目的所有依赖项，而无需将其存储在源代码管理中。 这可以使开发环境变得更整洁并减小存储库。 可以使用 NuGet 还原任务、NuGet CLI 或 .NET Core CLI 来还原 NuGet 包。 本文介绍如何使用经典和 YAML 管道还原 NuGet 包。

先决条件

• Azure DevOps 组织。 如果你没有组织，请创建一个组织。
• 一个 Azure DevOps 项目。 如果你没有项目，可以创建一个新项目。
• 一个 Azure Artifacts 源。 如果你没有源，请创建一个新源。
• 连接到 Azure Artifacts 源：NuGet.exe、dotnet。
• 设置管道权限。

从源还原 NuGet 包

经典

1. 导航到你的经典管道定义，然后选择编辑。

2. 选择 + 以添加新任务。 搜索 NuGet，然后选择添加以将任务添加到管道。

3. 为任务命名，然后从命令中选择还原。

4. 选择我在此处选择的源，然后从下拉菜单中选择你的源。 如果你要使用自己的配置文件，请选择我的 NuGet.config 中的源，并输入 NuGet.config 文件的路径和服务连接（如果你要使用组织外部的源进行身份验证）。

5. 如果你要包含来自 NuGet.org 的包，请选中使用来自 NuGet.org 的包复选框。

6. 完成后，选择“保存并排队”。

   

注意

经典 NuGet 还原使用 NuGetCommand@2 任务。 默认情况下，此版本使用 NuGet 4.1.0。 如果你要使用其他 NuGet 版本，请使用 NuGet 工具安装程序任务。

YAML

- task: NuGetCommand@2
  displayName: NuGet v2 Restore
  inputs:
    command: restore                      
    restoreSolution: '**/*.sln'             ## Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
    feedsToUse: 'select'                    ## Required. Feeds to use. 'select' | 'config'. Alias: selectOrConfig. Default: select.
    vstsFeed: '<PROJECT_NAME>/<FEED_NAME>'  ## Required when feedsToUse == Select. Use packages from this Azure Artifacts feed. 
    includeNuGetOrg: true                   ## Use packages from upstream (NuGet.org)

在本地还原 NuGet 包

将 nuget.config 放置在 .csproj 或 .sln 文件所在的同一文件夹中。 配置文件应如以下示例所示：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <!-- remove inherited connection strings -->
    <clear />
    <!-- add an Azure Artifacts feed -->
    <add key="FabrikamFiber" value="https://pkgs.dev.azure.com/microsoftLearnModule/_packaging/FabrikamFiber/nuget/v3/index.json" />
    <!-- Get packages from NuGet.org -->
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
  </packageSources>
</configuration>

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

nuget.exe restore

从其他组织中的源还原 NuGet 包

若要从其他 Azure DevOps 组织中的源还原 NuGet 包，必须使用个人访问令牌进行身份验证。

创建个人访问令牌

1. 导航到你的 Azure DevOps 组织，然后选择用户设置>个人访问令牌。

   

2. 创建范围为打包(读取)的个人访问令牌，并将此 PAT 复制到剪贴板。

   

还原 NuGet 包

经典

1. 导航到你的管道定义并选择 NuGet 还原任务。 确保使用任务版本 2。

   

2. 选择源和身份验证，然后选择我的 NuGet.config 中的源。

3. 选择 NuGet.config 文件的路径。

4. 选择新建以添加此组织/集合外部的源的凭据。

   

5. 选择外部 Azure DevOps Server，然后输入你的源 URL（确保与 NuGet.config 中的 URL 匹配）、服务连接名称以及之前创建的个人访问令牌。 完成时选择保存。

   

6. 完成后，选择“保存并排队”。

YAML

- task: NuGetCommand@2
  displayName: NuGet Restore
  inputs:
    restoreSolution: '**/*.sln'                     ## Required when command = restore. Path to your project's solution, packages.config, or project.json.
    feedsToUse: 'config'                            ## Required. 'select' | 'config'. Default: select.
    nugetConfigPath: 'Deployment/NuGet.config'      ## Required when selectOrConfig = config. Path to your nuget.config file.
    externalFeedCredentials: 'MyServiceConnection'  ## Use when selectOrConfig = config. The name of your service connection. Credentials for feeds outside your organization/collection.  

常见问题解答

问：为何我的管道无法还原 NuGet 包？

答：NuGet 还原任务可能由于多种原因而失败。 最常见的方案是添加需要目标框架的新项目时，你的管道在使用的 NuGet 版本不支持该目标框架。 此故障通常不会在本地开发环境中发生，因为 Visual Studio 会相应地更新你的解决方案。 请确保将你的 NuGet 任务升级到最新版本。

相关文章

• 发布到 NuGet 源（YAML/经典）
• 发布和使用生成工件
• 使用专用包源时如何降低风险