Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022
借助 Azure Artifacts 上游源,开发人员可以轻松地从公共注册表(如 nuget.org 和 npmjs.com)拉取包。 本文介绍如何设置项目,并通过命令行从 NuGet Gallery 获取 NuGet 包。
先决条件
| 产品 | 要求 |
|---|---|
| Azure DevOps | - 一个 Azure DevOps 组织。 - Azure DevOps 项目。 - Azure Artifacts 源。 - 下载并安装 Azure Artifacts 凭据提供程序。 - 安装最新的 NuGet 版本。 |
创建数据流并启用上游数据源
如果尚未创建源,请按照以下步骤创建新源并启用上游源。 如果已有源,请转到 下一步,将 NuGet 画廊添加为上游源。
登录到 Azure DevOps 组织,并导航到你的项目。
选择工件,然后选择创建 Feed。
为您的订阅源提供 名称,选择 可见性 选项以定义谁可以查看您的包,然后选择您的范围。 Azure Artifacts 建议将源范围限定为项目,而不是整个组织。
请确保勾选包括来自公共源的包选项,因为你需要从公共注册表(如nuget.org、npmjs.com等)中获取包。
完成操作后,选择“创建”。
添加 NuGet 库上游源
如果在创建源时选中了上游源复选框(如上一部分所示),则 NuGet 库应已自动添加到源的上游源。 如果您使用的是不同的源(feed)或忘记检查该选项,可以按照以下步骤手动添加 NuGet Gallery:
登录到 Azure DevOps,然后导航到项目。
选择“ 项目”,然后从下拉菜单中选择源。
选择齿轮图标按钮
以导航到 信息流设置。
选择“ 上游源”,然后选择“ 添加上游”。
从下拉菜单中选择 公共源,选择 NuGet 库,然后选择 添加。
选择右上角的 “保存 ”,然后选择“ 保存 ”以确认并应用更改。
连接到信息流
本部分介绍如何设置项目以对 Azure Artifacts 源进行身份验证,并保存来自上游源(如 NuGet Gallery)的包。
登录到 Azure DevOps 组织,并导航到你的项目。
选择工件,然后从下拉菜单中选择您的馈送。
选择“ 连接到源”,然后选择“ NuGet.exe”。
请确保已安装必备组件,然后将 nuget.config 文件添加到 与 .csproj 或 .sln 文件相同的文件夹中。
将 “项目设置 ”部分中提供的 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>
登录到 Azure DevOps 集合,然后导航到项目。
选择制品,然后从下拉菜单中选择你的订阅源。
选择 连接到馈源,然后从左侧导航面板中选择 NuGet.exe。
请按照项目设置部分中的说明连接到您的信息流。
从 NuGet 画廊安装软件包
注意
若要从上游源保存包,您必须具有 Feed 和上游读取权限(协作者) 或更高级别的权限。 有关更多详细信息,请参阅管理权限。
将项目配置为使用 Azure Artifacts 源进行身份验证后,可以继续从 NuGet 库上游安装包。 在此示例中,你将安装适用于 .NET 应用程序的模型上下文协议的 MCP C# SDK ,以便与 MCP 客户端和服务器交互:
导航到
https://www.nuget.org/上的 NuGet Gallery。搜索 ModelContextProtocol,然后选择它以打开详细信息页。
选择 .NET CLI 选项卡,并复制命令。 在此示例中,该命令为:
dotnet add package ModelContextProtocol --version 0.3.0-preview.4打开命令提示符窗口,导航到项目目录,然后粘贴命令,然后按 Enter 安装包。
安装后,包的副本将自动保存到您的源中,以确保万一 NuGet Gallery 出现故障,您的源仍可访问。同时,它保护您的工作流,免受来自公共注册表的其他损坏或恶意包的影响。
注意
若要从上游保存包,必须具有 供给和上游读取者(协作者) 角色或更高级别。 有关更多详细信息,请参阅 源角色和权限 。
查看保存的包
登录到 Azure DevOps,并导航到项目。
选择项目,然后从下拉菜单中选择源。
从下拉菜单中选择源为NuGet Gallery,筛选来自此上游的包。
上一步中安装的 ModelContextProtocol 包现在可以在我们的馈送中使用。 Azure Artifacts 会自动将副本保存到源。