快速入门:开始使用 Azure Artifacts 中的 NuGet 包

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

Azure Artifacts 允许开发人员从各种源(如馈送和公共注册表)发布和下载 NuGet 包。 可以通过 Azure Artifacts 创建以下任一类型的源:

  • 专用,因此你可以与团队和特定用户共享包。
  • 公开,以便你可以与 Internet 上的任何人公开共享包。

在此快速入门中,您将学习如何:

  • 创建新源。
  • 设置项目并连接到源。
  • 发布 NuGet 包。
  • 从源下载包。

先决条件

创建信息流

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

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

  3. 为源提供一个名称,选择定义谁可以查看包的可见性选项;如果想包含来自 nuget.orgnpmjs.com 等源的包,请选中包含来自公共源的包,对于范围,决定源的范围是项目还是整个组织。

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

    显示用于在 Azure DevOps Services 中创建新源的选择的屏幕截图。

  1. 登录到 Azure DevOps 服务器,然后转到项目。

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

  3. 为你的源流提供 名称,选择定义谁可以查看你的包的 可见性 选项,如果想要包括来自公共源(如 nuget.orgnpmjs.com)的包,请检查 包括公共源中的包,对于 范围,必须决定源流是仅限于项目还是整个组织使用。

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

    显示用于在 Azure DevOps 2022 中创建新订阅源的选项的屏幕截图。

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

    显示用于在 Azure DevOps 2020 中创建新源的选择的屏幕截图。

  1. 登录到 Azure DevOps 服务器,然后转到项目。

  2. 选择项目,然后选择新源

  3. 对于名称,输入源的描述性名称。

    对于可见性,请选择一个选项来指示谁可以查看信息源中的包。

    如果要包含来自公共源的包,请选择通过此源使用来自公共源的包选项。

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

    显示用于在 Azure DevOps 2019 中创建新 feed 的选择的屏幕截图。

注意

默认情况下,新创建的源将其项目的生成服务值设置为源和上游读取器(参与者)

连接到源

  1. 登录到 Azure DevOps 组织,然后转到项目。

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

  3. 选择连接到Feed,然后从左窗格中选择NuGet.exe。 如果这是你第一次将 Azure Artifacts 与Nuget.exe一起使用,请确保已安装所有先决条件。

    显示了用于连接到源的按钮的屏幕截图。

  4. 按照“项目设置”部分中的说明配置 nuget.config 文件并使用 Azure Artifacts 进行身份验证。

    用于设置项目的屏幕指示说明的屏幕截图。

  1. 登录到 Azure DevOps 服务器,然后转到项目。

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

  3. 选择Connect to Feed,然后从左窗格中选择NuGet.exe

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

    显示有关在 Azure DevOps Server 2020 和 2022 中设置 NuGet 项目的屏幕说明的屏幕截图。

  1. 登录到 Azure DevOps 服务器,然后转到项目。

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

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

  4. 按照说明将包源 URL 添加到 nuget.config

    显示有关在 Azure DevOps Server 2019 中设置 NuGet 项目的屏幕说明的屏幕截图。

下载软件包

1.获取包源 URL

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

  2. 选择“Artifacts”,从下拉菜单中选择源,然后选择“连接到源”

  3. 从左侧导航窗格中选择“NuGet”,然后复制“包源 URL”

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

  2. 选择“Artifacts”,从下拉菜单中选择源,然后选择“连接到源”

  3. 从左侧导航窗格中选择“Visual Studio”,然后复制“来源”URL。

    显示如何查找订阅源的 URL 的屏幕截图。

2.设置 Visual Studio

  1. 在 Visual Studio 中,选择“工具”“选项”。

  2. 展开“NuGet 程序包管理器”部分,然后选择“包源”。

  3. 输入订阅源的Name值和Source URL,然后选择绿色加号(+)以添加一个源。

  4. 如果在源中启用了上游源,请取消选中“nuget.org”复选框。

  5. 完成后,选择“确定”。

    一张屏幕截图显示了在 Windows 中设置 Visual Studio 的选项。

3. 下载软件包

  1. 在 Visual Studio 中,右键单击项目,然后选择“ 管理 NuGet 包”。

  2. 选择“浏览”,然后从“包源”下拉菜单中选择你的源。

    显示在 Visual Studio 中选择包源的屏幕截图。

  3. 使用搜索栏从源中搜索包。

注意

不支持使用 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 源时可以使用任意值。