快速入門:開始使用 Azure Artifacts 中的 NuGet 套件
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Azure Artifacts 可讓開發人員從摘要和公用登錄等來源發佈和下載 NuGet 套件。 使用 Azure Artifacts,您可以建立下列其中一種摘要:
- 私人,因此您可以與小組和特定用戶共用套件。
- 公開,因此您可以與互聯網上的任何人分享套件。
在此快速入門中,您可了解如何:
- 建立新的資訊流。
- 建立您的專案並連線到您的資訊來源。
- 發佈 NuGet 套件。
- 從您的來源下載套件。
必要條件
建立摘要
登入您的 Azure DevOps 組織,並流覽至您的專案。
選取 [工件],然後選取 [建立資訊流]。
為您的摘要提供 名稱,選擇定義誰可以檢視您套件的 Visibility 選項,然後如果您想要包含來自一般公用來源如 nuget.org 或 npmjs.com的套件,請勾選 [包含來自一般公用來源的套件]。針對 Scope,決定您的摘要是否應限定在您的專案中或整個組織中。
完成後,選取 建立。
登入您的 Azure DevOps 伺服器,然後移至您的專案。
選取 [工件],然後選取 [建立資訊流]。
為您的摘要提供 名稱,選擇定義誰可以檢視您套件的 Visibility 選項,然後如果您想要包含來自一般公用來源如 nuget.org 或 npmjs.com的套件,請勾選 [包含來自一般公用來源的套件]。針對 Scope,決定您的摘要是否應限定在您的專案中或整個組織中。
完成後,選取 建立。
完成後,選取 建立。
注意
根據預設,新建立的饋送會將其專案的建置服務值設定為饋送和上游讀取器(共同作業者)。
連接到訊息來源
登入您的 Azure DevOps 組織,然後移至您的專案。
選取 產物,然後從下拉選單中選取您的饋送。
選取 連接到來源,然後從左窗格中選取 NuGet.exe。 如果這是您第一次搭配 Nuget.exe使用 Azure Artifacts,請確定您已安裝所有必要條件。
請遵循 Project 安裝程式一節中的指示來設定 nuget.config 檔案,並使用 Azure Artifacts 進行驗證。
登入您的 Azure DevOps 伺服器,然後移至您的專案。
選取 產物,然後從下拉選單中選取您的饋送。
選取 連接到來源,然後從左窗格中選取 NuGet.exe。
請遵循 項目設定 區段中的指示,連接到您的訊息來源。
下載套件
1.取得套件來源 URL
登入您的 Azure DevOps 組織,然後流覽至您的專案。
選取 項目,從下拉功能表中選取您的訂閱源,然後選取 連接到訂閱源。
從左側瀏覽窗格中選取 [Visual Studio],然後複製您的 Source URL。
2.設定 Visual Studio
在 Visual Studio 中,選取 [工具>選項]。
展開 [NuGet 封裝管理員] 區段,然後選取 [套件來源]。
輸入摘要的 [名稱] 值和 [來源 URL],然後選取綠色加號 (+) 以新增來源。
如果您在摘要中啟用上游來源,請清除 [nuget.org ] 複選框。
當您完成時,選取 [確定]。
螢幕快照顯示在 Windows 中設定 Visual Studio 的選項。
3.下載套件
在 Visual Studio 中,以滑鼠右鍵按兩下您的項目,然後選取 [ 管理 NuGet 套件]。
選取瀏覽,然後從套件來源下拉功能表中選取您的供應項目。
請使用搜索欄搜尋您動態消息中的套件。
注意
不支援使用 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 摘要時使用任何任意值。