分享方式:


連線 至 Azure Artifacts 摘要 (NuGet.exe)

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

Azure Artifacts 可讓開發人員從各種來源發佈和下載 NuGet 套件,包括摘要和公用登錄。 您可以使用私人 Azure Artifacts 摘要,私下與小組或特定用戶共用套件。 此外,您可以建立公用摘要,讓套件可供公開存取,讓您與因特網上的任何人公開共用這些摘要。 本文將引導您連線到 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 ,因為它包含與取消和逾時相關的重要錯誤修正。

舊版項目設定

如果您使用舊版的 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>