共用方式為


使用 NuGet 資源庫中的套件

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

Azure Artifacts 上游來源可讓開發人員輕鬆地從公用登錄 (例如 nuget.orgnpmjs.com) 提取套件。 在本文中,您將瞭解如何設定專案,並使用命令列從 NuGet 資源庫取用 NuGet 套件。

必要條件

產品 要求
Azure DevOps - Azure DevOps 組織
- Azure DevOps 項目
- Azure Artifacts 資料饋送
- 下載並安裝 Azure Artifacts 認證提供者
- 安裝最新的 NuGet 版本

建立摘要並啟用上游來源

如果您尚未建立摘要,請依照下列步驟建立新摘要並啟用上游來源。 如果您已經有資訊提供,請繼續進行下一個步驟,將 NuGet 套件庫新增為上游來源。

  1. 登入您的 Azure DevOps 組織,並流覽至您的專案。

  2. 選取 工件,然後選取 建立訊息源

  3. 提供摘要的名稱,選取 [可見度] 選項以定義誰可以檢視您的套件,然後選擇您的 [範圍]。 Azure Artifacts 建議將摘要範圍限定為專案,而不是整個組織。

  4. 請務必核取 [包含來自常見公用來源的套件] 選項,因為您需要此選項才能使用公用註冊表 ( 例如 nuget.orgnpmjs.com 等) 的套件。

  5. 完成後,選擇 [建立]

    螢幕擷取畫面,顯示如何在 Azure Artifacts 中建立新的摘要,並啟用上游來源。

如果您在建立摘要時核取 [上游來源] 核取方塊 (如上一節所示),NuGet 資源庫應該已自動新增至摘要的上游來源。 如果您使用不同的摘要或忘記核取該選項,您可以遵循下列步驟手動新增 NuGet 資源庫:

  1. 登入 Azure DevOps,然後流覽至您的專案。

  2. 選取 構件,然後從下拉選單中選取您的資料流。

  3. 選取齒輪圖示按鈕 齒輪圖示 以流覽至您的 摘要設定

  1. 選取 [ 上游來源],然後選取 [ 新增上游]。

  2. 選取 [公用來源],從下拉式功能表中選取 [NuGet 資源庫],然後選取 [新增]。

  3. 選取右上角的 儲存 ,然後再次選取 儲存 以 確認並套用您的變更。

連接到您的資訊流

在本節中,您將瞭解如何設定專案以使用 Azure Artifacts 摘要進行驗證,並從上游來源 (例如 NuGet 資源庫) 儲存套件。

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

  2. 選取 構件,然後從下拉選單中選取您的資料流。

  3. 選取 [連線至 feed],然後選取 [NuGet.exe]

  4. 請確定您已安裝必要條件,然後在與 .csproj.sln 檔案相同的資料夾中新增 nuget.config 檔案。

  5. 專案設定 區段中提供的 XML 程式碼片段貼到您的檔案中。 您的檔案應該如下所示:

    • 專案範圍的資料流

      <?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. 請遵循 專案設定 區段中的指示,連接到您的信息來源。

現在您的專案已設定為使用 Azure Artifacts 摘要進行驗證,您可以繼續從 NuGet 資源庫上游安裝套件。 在此範例中,您將安裝 MCP C# SDK ,以用於 .NET 應用程式的模型內容通訊協定,以與 MCP 用戶端和伺服器互動:

  1. 請導航至 https://www.nuget.org/ 的 NuGet 套件庫。

  2. 搜尋 ModelContextProtocol,然後選取它以開啟詳細資料頁面。

  3. 選取 [.NET CLI ] 索引標籤,然後複製命令。 在本例中,命令為:

    dotnet add package ModelContextProtocol --version 0.3.0-preview.4
    
  4. 開啟命令提示字元視窗,導覽至您的專案目錄,然後貼上您的命令並按 Enter 鍵安裝套件。

安裝之後,套件的複本會自動儲存至您的摘要,以確保 NuGet 資源庫關閉時的可用性,並保護您的工作流程免於公用登錄中其他損毀或惡意套件的侵害。

注意

若要從上游保存套件,您必須具有 資料流與上游讀取者(協作者) 角色或更高權限。 如需更多詳細資訊,請參閱提要角色和權限。

檢視已儲存的套件

  1. 登入 Azure DevOps,然後流覽至您的專案。

  2. 選取工件,然後從下拉式選單中選取您的饋送。

  3. 從下拉選單中選取 NuGet Gallery 來源,以篩選此上游的套件。

  4. 在上一個步驟中安裝的 ModelContextProtocol 套件現在可在我們的摘要中使用。 Azure Artifacts 會自動將複本儲存至您的摘要。

    顯示儲存至摘要的 MCP 套件的螢幕擷取畫面。