快速入门:开始使用 Azure Artifacts 中的 NuGet 包
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Azure Artifacts 允许开发人员从各种源(如馈送和公共注册表)发布和下载 NuGet 包。 可以通过 Azure Artifacts 创建以下任一类型的源:
- 专用,因此你可以与团队和特定用户共享包。
- 公开,以便你可以与 Internet 上的任何人公开共享包。
在此快速入门中,您将学习如何:
- 创建新源。
- 设置项目并连接到源。
- 发布 NuGet 包。
- 从源下载包。
先决条件
创建信息流
登录到 Azure DevOps 组织并导航到项目。
选择“项目”,然后选择“创建源”。
为源提供一个名称,选择定义谁可以查看包的可见性选项;如果想包含来自 nuget.org 或 npmjs.com 等源的包,请选中包含来自公共源的包,对于范围,决定源的范围是项目还是整个组织。
完成操作后,选择“创建”。
登录到 Azure DevOps 服务器,然后转到项目。
选择“项目”,然后选择“创建源”。
为你的源流提供 名称,选择定义谁可以查看你的包的 可见性 选项,如果想要包括来自公共源(如 nuget.org 或 npmjs.com)的包,请检查 包括公共源中的包,对于 范围,必须决定源流是仅限于项目还是整个组织使用。
完成操作后,选择“创建”。
完成操作后,选择“创建”。
登录到 Azure DevOps 服务器,然后转到项目。
选择项目,然后选择新源。
对于名称,输入源的描述性名称。
对于可见性,请选择一个选项来指示谁可以查看信息源中的包。
如果要包含来自公共源的包,请选择通过此源使用来自公共源的包选项。
完成操作后,选择“创建”。
注意
默认情况下,新创建的源将其项目的生成服务值设置为源和上游读取器(参与者)。
连接到源
登录到 Azure DevOps 组织,然后转到项目。
选择“ 项目”,然后从下拉菜单中选择源。
选择连接到Feed,然后从左窗格中选择NuGet.exe。 如果这是你第一次将 Azure Artifacts 与Nuget.exe一起使用,请确保已安装所有先决条件。
按照“项目设置”部分中的说明配置 nuget.config 文件并使用 Azure Artifacts 进行身份验证。
登录到 Azure DevOps 服务器,然后转到项目。
选择“ 项目”,然后从下拉菜单中选择源。
选择Connect to Feed,然后从左窗格中选择NuGet.exe。
按照项目设置部分中的说明连接到源。
登录到 Azure DevOps 服务器,然后转到项目。
选择“ 项目”,然后从下拉菜单中选择源。
选择“连接到源”,然后从左窗格中选择“NuGet”。
按照说明将包源 URL 添加到 nuget.config。
下载软件包
1.获取包源 URL
登录到 Azure DevOps 服务器,然后导航到项目。
选择“Artifacts”,从下拉菜单中选择源,然后选择“连接到源”。
从左侧导航窗格中选择“NuGet”,然后复制“包源 URL”。
登录到 Azure DevOps 组织,然后导航到项目。
选择“Artifacts”,从下拉菜单中选择源,然后选择“连接到源”。
从左侧导航窗格中选择“Visual Studio”,然后复制“来源”URL。
2.设置 Visual Studio
在 Visual Studio 中,选择“工具”“选项”。
展开“NuGet 程序包管理器”部分,然后选择“包源”。
输入订阅源的Name值和Source URL,然后选择绿色加号(+)以添加一个源。
如果在源中启用了上游源,请取消选中“nuget.org”复选框。
完成后,选择“确定”。
3. 下载软件包
在 Visual Studio 中,右键单击项目,然后选择“ 管理 NuGet 包”。
选择“浏览”,然后从“包源”下拉菜单中选择你的源。
使用搜索栏从源中搜索包。
注意
不支持使用 NuGet 包资源管理器搜索上游源中的包。
发布软件包
要将包发布到源中,请运行以下命令。 可以为参数输入任何字符串 ApiKey
。
nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>
示例:
项目作用域的源:
nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
组织作用域的源:
nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/_packaging/myFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
注意
ApiKey
是必需的,但在发布到 Azure Artifacts 源时可以使用任意值。