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