共用方式為


在公共饋送中使用上游來源

Azure DevOps Services

Azure Artifacts 可讓開發人員從單一來源管理其相依性。 您可以使用上游來源的資源,從饋送和公共註冊中取用套件,例如 NuGet.org 和 npmjs.com。 在本文中,您將學會如何:

  • 建立公開動態
  • 啟用上游來源
  • 新增上游來源

必要條件

建立公共資訊流

公共信息流是在公共專案中的專案範圍的訊息流。 公共動態繼承了主控專案的可見性設定。

  1. 登入您的 Azure DevOps 組織,然後選取您的公用專案。

  2. 選取 [ 成品],然後選取 [ 建立摘要]。

    顯示 Azure Artifacts 中 [建立摘要] 按鈕的螢幕快照。

  3. 為您的動態消息指定名稱,然後選取專案:PublicProject(推薦)作為其範圍。

    螢幕快照顯示如何建立新的公開動態。

  4. 完成後,按下[建立]

重要

公用摘要不支援上游至私人 Artifacts 摘要。 如果您使用公開的 Azure Artifacts 摘要,則只能向公開的註冊表(NuGet.org、npmjs)或其他 公開的 Azure Artifacts 摘要上傳。

新增上游來源

  1. 登入您的 Azure DevOps 組織,然後選取您的公用專案。

  2. 選取 [ 成品],然後選取您的公用摘要。

  3. 選擇齒輪圖示 齒輪圖示 以進入您的 動態消息設定

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

    顯示如何在公用摘要中新增上游來源的螢幕快照。

  5. 選取上游來源 類型。 在此範例中,我們會將 NuGet.org 新增為上游來源。

    顯示不同類型的上游來源螢幕快照。

  6. 設定來源,然後在完成時選取 [ 新增 ]。

    顯示如何設定上游來源的螢幕快照。

  7. 選取 [ 儲存 ] 以儲存新的上游來源。

    顯示如何儲存新增上游來源的螢幕快照。

重要

需要套件鎖定檔案 ,才能將 NuGet 和 Dotnet 套件從上游來源儲存到公用摘要。

復原套件

在項目目錄中執行下列命令來還原套件:

nuget.exe restore

備註

您必須是 摘要和上游讀取器(協作者)或更高層級,才能從上游安裝新的套件版本。 匿名使用者只能安裝存在於其饋送中的套件。

Q&A

問:我嘗試恢復我的套件,但我持續收到 401 未經授權的錯誤?

提要的內容只能由已驗證和授權,且在提要上擁有適當許可權的身份進行變更。 這包括將套件儲存到來自上游來源的資料饋送中。 未經驗證的(匿名)用戶可以 下載已儲存 到摘要中的套件,但無法將上游的新套件儲存到摘要中。

項目的維護人員應該將所有必要的套件版本儲存到公共饋送中。 這可以藉由使用具有可在提示時提供驗證的身份來還原專案,並確保所使用的身份在公共訊息源上擁有「訊息源和上游讀取者(協作者)」或更高的許可權。

如果針對專案還原套件的匿名使用者,由於認證要求(401 回應)被重複封鎖,下列方法將會緩解或解決此問題:

  1. 請避免在專案組態中使用套件版本範圍。 明確套件版本可確保封裝用戶端只會要求所需的確切版本。

  2. 支援時,請利用封裝生態系統的鎖定檔案,讓封裝用戶端只會在還原/安裝作業期間要求專案所需的特定版本。

問:我正在嘗試使用 Visual Studio 還原套件,但我注意到它們是從不同的來源抓取的。

答:請確定 Visual Studio 使用的是 nuget.config 檔案中參考的來源,而非來自本機 NuGet 套件管理員的來源。 如需詳細資訊,請參閱套件來源。

您也可以執行下列命令,使用 NuGet CLI 強制 NuGet 使用組態檔中的來源:

nuget restore -config <PATH_TO_NUGET_CONFIG_FILE>