使用 NuGet 库中的包

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

借助 Azure Artifacts 上游源,开发人员可以轻松地从公共注册表(如 nuget.orgnpmjs.com)拉取包。 本文介绍如何设置项目并使用命令行从 NuGet 库使用 NuGet 包。

先决条件

产品 要求
Azure DevOps - 一个 Azure DevOps 组织
- Azure DevOps 项目
- Azure Artifacts
- 下载并安装 Azure Artifacts 凭据提供程序
- 安装最新的 NuGet 版本

创建源并启用上游源

如果尚未创建源,请按照以下步骤创建新源并启用上游源。 如果已有源,请转到 下一步 ,将 NuGet 库添加为上游源。

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

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

  3. 为源提供 名称 ,选择 “可见性 ”选项以定义谁可以查看包,然后选择 范围。 Azure Artifacts 建议将源范围限定为项目,而不是整个组织。

  4. 请务必检查 “包括公共源”选项中的“包括包 ”选项,因为需要使用公共注册表中的包,例如 nuget.orgnpmjs.com 等。

  5. 完成操作后,选择“创建”

    显示如何在 Azure Artifacts 中创建新源并启用上游源的屏幕截图。

如果在创建源时选中了上游源复选框(如上一部分所示),则 NuGet 库应已自动添加到源的上游源。 如果使用的是其他源或忘记检查该选项,可以按照以下步骤手动添加 NuGet 库:

  1. 登录到 Azure DevOps,然后导航到项目。

  2. 选择“ 项目”,然后从下拉菜单中选择源。

  3. 选择齿轮图标按钮 齿轮图标 以导航到 源设置

  1. 选择“ 上游源”,然后选择“ 添加上游”。

  2. 从下拉菜单中选择 “公共源”,选择 “NuGet 库 ”,然后选择“ 添加”。

  3. 选择右上角的 “保存 ”,然后选择“ 保存 ”以确认并应用更改。

  1. 选择 上游源,然后选择“ 添加上游源”。

  2. 选择 “公共源”,然后从下拉菜单中选择 “NuGet 库 ”。

  3. 完成后,选择“添加”

连接到源

本部分介绍如何设置项目以使用 Azure Artifacts 源进行身份验证,以及保存来自上游源(如 NuGet 库)的包。

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

  2. 选择“ 项目”,然后从下拉菜单中选择源。

  3. 选择“ 连接到源”,然后选择“ NuGet.exe”。

  4. 请确保已安装必备组件,然后将 nuget.config 文件添加到 与 .csproj.sln 文件相同的文件夹中。

  5. “项目设置 ”部分中提供的 XML 代码片段粘贴到文件中。 您的文件应如下所示:

    • 项目范围的源

      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
    • 组织范围的源

      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
  1. 登录到 Azure DevOps 集合,然后导航到项目。

  2. 选择“ 项目”,然后从下拉菜单中选择源。

  3. 选择“ 连接到源”,然后从左侧导航窗格中选择 NuGet.exe

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

将项目配置为使用 Azure Artifacts 源进行身份验证后,可以继续从 NuGet 库上游安装包。 在此示例中,你将安装适用于 .NET 应用程序的模型上下文协议的 MCP C# SDK ,以便与 MCP 客户端和服务器交互:

  1. 导航到 NuGet 库。https://www.nuget.org/

  2. 搜索 ModelContextProtocol,然后选择它以打开详细信息页。

  3. 选择 .NET CLI 选项卡,并复制命令。 在此示例中,该命令为:

    dotnet add package ModelContextProtocol --version 0.3.0-preview.4
    
  4. 打开命令提示符窗口,导航到项目目录,然后粘贴命令,然后按 Enter 安装包。

安装后,包的副本将自动保存到源,确保 NuGet 库关闭并保护工作流免受公共注册表中其他损坏或恶意包的影响。

注意

若要从上游保存包,必须具有 源和上游读取者(协作者) 角色或更高版本。 有关更多详细信息,请参阅 源角色和权限

查看保存的包

  1. 登录到 Azure DevOps,并导航到项目。

  2. 选择项目,然后从下拉菜单中选择源。

  3. 从下拉菜单中选择 NuGet 库源,筛选来自此上游的包。

  4. 在上一步中安装的 ModelContextProtocol 包现在在我们的源中可用。 Azure Artifacts 会自动将副本保存到源。

    显示保存到源的 MCP 包的屏幕截图。