快速入門:開始使用 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 伺服器,然後移至您的專案。
選取 [ 工件],然後選取 [ 新增摘要]。
針對名稱,輸入供稿的描述性名稱。
針對 Visibility,選取一個選項來指出誰可以查看資訊來源內的套件。
如果您想要包含來自公共來源的套件,請選取 [使用此來源的公共套件] 選項。
完成後,選擇建立。
注意
根據預設,新建立的饋送會將其專案的建置服務值設定為饋送和上游讀取器(共同作業者)。
連接到訊息來源
登入您的 Azure DevOps 組織,然後移至您的專案。
選取 產物,然後從下拉選單中選取您的饋送。
選取 連接到來源,然後從左窗格中選取 NuGet.exe。 如果這是您第一次搭配 Nuget.exe使用 Azure Artifacts,請確定您已安裝所有必要條件。
請遵循 Project 安裝程式一節中的指示來設定 nuget.config 檔案,並使用 Azure Artifacts 進行驗證。
登入您的 Azure DevOps 伺服器,然後移至您的專案。
選取 [ 成品],然後從下拉功能表中選取您的摘要。
選取 [連接到摘要],然後從左窗格中選取 NuGet.exe。
請遵循 項目設定 區段中的指示,連接到您的訊息來源。
登入您的 Azure DevOps 伺服器,然後移至您的專案。
選取產物,然後從下拉選單中選取您的資訊流。
選取 連接至 Feed,然後從左窗格中選取 NuGet。
請遵循指示,將套件來源 URL 新增至 nuget.config。
下載套件
1.取得套件來源 URL
登入您的 Azure DevOps 伺服器,然後流覽至您的專案。
選取 [成品],從下拉功能表中選取您的摘要,然後選取 [ 連線到摘要]。
從左側瀏覽窗格中選取 [NuGet],然後複製 套件來源 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 摘要時使用任何任意值。