共用方式為


快速入門:開始使用 Azure Artifacts 中的 NuGet 套件

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

Azure Artifacts 可讓開發人員從摘要和公用登錄等來源發佈和下載 NuGet 套件。 使用 Azure Artifacts,您可以建立下列其中一種摘要:

  • 私人,因此您可以與小組和特定用戶共用套件。
  • 公開,因此您可以與互聯網上的任何人分享套件。

在此快速入門中,您可了解如何:

  • 建立新的資訊流。
  • 建立您的專案並連線到您的資訊來源。
  • 發佈 NuGet 套件。
  • 從您的來源下載套件。

必要條件

建立摘要

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

  2. 選取 [工件],然後選取 [建立資訊流]。

  3. 為您的摘要提供 名稱,選擇定義誰可以檢視您套件的 Visibility 選項,然後如果您想要包含來自一般公用來源如 nuget.orgnpmjs.com的套件,請勾選 [包含來自一般公用來源的套件]。針對 Scope,決定您的摘要是否應限定在您的專案中或整個組織中。

  4. 完成後,選取 建立

    此螢幕快照顯示在 Azure DevOps Services 中建立新摘要的選項。

  1. 登入您的 Azure DevOps 伺服器,然後移至您的專案。

  2. 選取 [工件],然後選取 [建立饋送]。

  3. 為您的摘要提供 名稱,選擇定義誰可以查看您套件的 Visibility 選項,如需包含來自 nuget.orgnpmjs.com等常見公共來源的套件,請核取 [包含來自一般公用來源的套件],針對 Scope,決定此摘要應限制於您的專案或整個組織。

  1. 完成後,選取建立

    此螢幕快照顯示在 Azure DevOps 2022 中建立新摘要的選項。

  1. 完成後,選擇建立

    此螢幕快照顯示在 Azure DevOps 2020 中建立新摘要的選項。

  1. 登入您的 Azure DevOps 伺服器,然後移至您的專案。

  2. 選取 [ 工件],然後選取 [ 新增摘要]。

  3. 針對名稱,輸入供稿的描述性名稱。

    針對 Visibility,選取一個選項來指出誰可以查看資訊來源內的套件。

    如果您想要包含來自公共來源的套件,請選取 [使用此來源的公共套件] 選項。

  4. 完成後,選擇建立

    此螢幕快照顯示在 Azure DevOps 2019 中建立新摘要的選項。

注意

根據預設,新建立的饋送會將其專案的建置服務值設定為饋送和上游讀取器(共同作業者)

連接到訊息來源

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

  2. 選取 產物,然後從下拉選單中選取您的饋送。

  3. 選取 連接到來源,然後從左窗格中選取 NuGet.exe。 如果這是您第一次搭配 Nuget.exe使用 Azure Artifacts,請確定您已安裝所有必要條件。

    顯示連接至資訊來源之按鈕的螢幕快照。

  4. 請遵循 Project 安裝程式一節中的指示來設定 nuget.config 檔案,並使用 Azure Artifacts 進行驗證。

    螢幕快照,顯示設定項目的畫面指示。

  1. 登入您的 Azure DevOps 伺服器,然後移至您的專案。

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

  3. 選取 [連接到摘要],然後從左窗格中選取 NuGet.exe

  4. 請遵循 項目設定 區段中的指示,連接到您的訊息來源。

    此螢幕快照顯示在 Azure DevOps Server 2020 和 2022 中設定 NuGet 項目的畫面指示。

  1. 登入您的 Azure DevOps 伺服器,然後移至您的專案。

  2. 選取產物,然後從下拉選單中選取您的資訊流。

  3. 選取 連接至 Feed,然後從左窗格中選取 NuGet

  4. 請遵循指示,將套件來源 URL 新增至 nuget.config

    螢幕快照,顯示在 Azure DevOps Server 2019 中設定 NuGet 項目的畫面指示。

下載套件

1.取得套件來源 URL

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

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

  3. 從左側瀏覽窗格中選取 [NuGet],然後複製 套件來源 URL

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

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

  3. 從左側瀏覽窗格中選取 [Visual Studio],然後複製您的 Source URL。

    顯示如何尋找摘要來源 URL 的螢幕快照。

2.設定 Visual Studio

  1. 在 Visual Studio 中,選取 [工具>選項]。

  2. 展開 [NuGet 封裝管理員] 區段,然後選取 [套件來源]。

  3. 輸入摘要的 [名稱] 值和 [來源 URL],然後選取綠色加號 (+) 以新增來源。

  4. 如果您在摘要中啟用上游來源,請清除 [nuget.org ] 複選框。

  5. 當您完成時,選取 [確定]

    螢幕快照顯示在 Windows 中設定 Visual Studio 的選項。

3.下載套件

  1. 在 Visual Studio 中,以滑鼠右鍵按兩下您的項目,然後選取 [ 管理 NuGet 套件]。

  2. 選取瀏覽,然後從套件來源下拉功能表中選取您的供應項目。

    顯示 Visual Studio 中選擇套件來源的螢幕快照。

  3. 請使用搜索欄搜尋您動態消息中的套件。

注意

不支援使用 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 摘要時使用任何任意值。