連線 至 Azure Artifacts 摘要 （NuGet.exe）

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

Azure Artifacts 可讓開發人員從各種來源發佈和下載 NuGet 套件，包括摘要和公用登錄。 您可以使用私人 Azure Artifacts 摘要，私下與小組或特定用戶共用套件。 此外，您可以建立公用摘要，讓套件可供公開存取，讓您與因特網上的任何人公開共用這些摘要。 本文將引導您連線到 Azure Artifacts 摘要。

必要條件

• Azure DevOps 組織和專案。 如果您尚未建立組織或專案。

• Azure Artifacts 摘要。 如果您還沒有摘要，請建立新的摘要 。

• 安裝最新的 NuGet 版本。

• 安裝 Azure Artifacts 認證提供者。

專案設定

1. 登入您的 Azure DevOps 組織，然後瀏覽至您的專案。

2. 選取 [ 成品]，然後從下拉功能表中選取您的摘要。

3. 選取要摘要 連線，然後從左面板中選取 [NuGet.exe]。

4. 如果這是您第一次搭配使用 Azure Artifacts 搭配NuGet.exe，請確定您已安裝必要條件，否則請選取 右上角的 [取得工具 ] 加以安裝。

5. 將 nuget.config 檔案新增至您的專案、將它放在與 csproj 或 sln 檔案相同的資料夾中，然後將所提供的代碼段貼入其中。 代碼段的結構應該像這樣：

   • 專案範圍的摘要：

     <?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 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> 
   

相關文章

• 發佈和還原 NuGet 套件 （NuGet.exe）
• 使用 Azure Pipelines 發佈 NuGet 套件
• 使用來自 NuGet.org 的套件