共用方式為


使用 Azure Artifacts 發佈及下載 NuGet 套件

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

Azure Artifacts 可讓開發人員從摘要或公用登錄發佈及下載 NuGet 套件。 資訊提供可以是私人的,讓您可以與特定的使用者分享套件,或是公用的,讓您的套件可以供互聯網上的任何人存取。

本文會引導您建立摘要、設定專案,以及發佈和下載 NuGet 套件。

必要條件

產品 要求
Azure DevOps - Azure DevOps 組織
- Azure DevOps 項目
- 下載並安裝 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 中建立新摘要的選項。

注意

根據預設,專案建置服務(例如:projectName Build Service (orgName)會在建立新摘要時指派摘要和上游讀取器(共同作業者)角色。

連接到訊息來源

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

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

  3. 選取 [連接到動態消息],然後從左側導覽窗格中選取 [NuGet.exe]。 如果這是您第一次使用 Azure Artifacts 搭配 Nuget.exe,請確保您已經安裝好所有必要的先決條件。

  4. 請遵循 專案設定 區段底下的提供的指示來設定 您的nuget.config 檔案,並連接到您的 Azure Artifacts 饋送。

    顯示如何在 Azure DevOps Services 中設定專案並連線到資料流的螢幕擷圖。

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

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

  3. 選取 [連接到動態消息],然後從左側導覽窗格中選取 [NuGet.exe]。

  4. 請遵循 專案設定 區段底下的提供的指示來設定 您的nuget.config 檔案,並連接到您的 Azure Artifacts 饋送。

    顯示如何在 Azure DevOps Server 2020 和 2022 中設定項目並連線到摘要的螢幕快照。

將套件發佈至您的饋送頻道

若要將套件發佈至摘要,請執行下列命令。 參數 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 摘要時使用任何任意值。

從您的資料流下載套件

若要從您的饋送還原套件,請在專案目錄中執行下列命令:

nuget.exe restore

注意

不支援使用 NuGet 套件瀏覽器在上游來源中搜尋套件。