连接 Azure Artifacts 源(NuGet.exe)

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

Azure Artifacts 使开发人员能够从各种源(包括源和公共注册表)发布和下载 NuGet 包。 可以使用专用 Azure Artifacts 源与团队或特定用户私下共享包。 此外,还可以创建公共源以公开访问包,从而允许你与 Internet 上的任何人公开共享它们。 本文将指导你连接到 Azure Artifacts 源。

先决条件

项目设置

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

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

  3. 选择要馈送的连接,然后从左侧面板中选择NuGet.exe

  4. 如果这是你第一次将 Azure Artifacts 与NuGet.exe一起使用,请确保已安装必备组件,否则请选择右上角的“ 获取工具 ”进行安装。

  5. 将 nuget.config 文件添加到项目,将其放置在与 csprojsln 文件相同的文件夹中,然后将提供的代码片段粘贴到其中。 代码片段的结构应如下所示:

    • 项目范围的源

      <?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. 按照“项目设置”部分中的说明连接到源。

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

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

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

  4. 按照提供的说明将包源 URL 添加到 nuget.config 文件。

重要

Azure Artifacts 凭据提供程序需要 NuGet 4.8.0.5385 或更高版本。

为了获得最佳性能,Azure Artifacts 建议使用 NuGet 版本 5.5.x 或更高版本,因为它包含与取消和超时相关的关键 bug 修复。

旧项目设置

如果使用的是旧版 NuGet,请按照以下说明连接到源:

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

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

  3. 选择要馈送的连接,然后从左侧面板中选择NuGet.exe

  4. 复制源 URL,然后替换为 /v3/index.json /v2。 更新的源 URL 应如下所示:

    • 项目范围的源

      https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2
      
    • 组织范围的源

      https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2
      
  5. 创建个人访问令牌,并确保将其范围限定为想要访问的正确组织,并选择以下范围之一:打包(读取)打包(读取和写入)打包(读取、写入和管理)。

  6. 在命令提示符窗口中运行以下命令,将源源添加到 nuget.config 文件:

    nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <ANY_STRING_BUT_NOT_NULL> -password <YOUR_PERSONAL_ACCESS_TOKEN>
    
  7. 如果组织已连接到 Microsoft Entra ID,必须先使用 AD 凭据进行身份验证,然后使用 setapikey 命令添加个人访问令牌:

    nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <AZURE_ACTIVE_DIRECTORY_USERNAME> -password <AZURE_ACTIVE_DIRECTORY_PASSWORD>
    
    nuget setapikey <YOUR_PERSONAL_ACCESS_TOKEN> -source <SOURCE_URL>