Azure Artifacts 最佳做法

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

Azure Artifacts 讓團隊有一個地方可以發佈、儲存、分享及使用套件。 隨著訂閱源、包裹和消費者數量增加,幾個早期決策可能讓包裹管理變得簡單或難以維護。 本文彙整了可協助你讓套件還原更可預測、以更高的控制程度發行套件,以及長期更輕鬆管理套件來源的做法。

核心指引

  • 每個用戶端設定檔只設一個串流,並在需要公開登錄檔或額外內部來源時啟用該串流的上游來源。 這種做法讓設定檔更簡單,也讓你的訂閱源提供更可預測的還原行為。 欲了解更多資訊,請參閱 「什麼是上游來源?」

  • 把動態瀏覽視為發佈頻道。 將新版本發佈到 @local,在那裡進行驗證,然後將已準備好供更廣泛使用的版本提升到 @prerelease@release。 這種方法有助於區分仍在評估中的套件版本與準備與更多消費者分享的版本。 欲了解更多資訊,請參閱 「什麼是動態檢視?」

  • 請有意識地設定訂閱權限。 決定誰可以發佈套件、誰可以從上游來源儲存套件,以及誰可以從共享檢視中消費套件。 明確的角色界線有助於保護資料並減少意外變更。 更多資訊請參閱 「飼料角色與權限」。

  • 在舊套件版本開始累積前,啟用保留政策。 舊版本可能會很快累積,尤其是在活躍的動態消息中。 保留政策有助於控制儲存空間的成長,並減少讓訂閱源維持在可管理狀態所需的工作量。 欲了解更多資訊,請參閱 「自動刪除套件與保留政策」。

套件發行者的最佳做法

遵循最佳做法有助於確保一致性、安全性和順暢的用戶體驗。 以下是使用 Azure Artifacts 發佈套件時的重要建議:

注意

您必須是Feed 發布者(貢獻者)或更高級別,才能將套件發布至信息源。 如需更多詳細資訊,請參閱提要角色和權限。

  • 為每個存放庫使用單一摘要

    訂閱源是一種組織結構,可以承載多種套件類型。 雖然專案可以使用多個串流,但通常最好將一個儲存庫連接到一個主要串流,以減少衝突並簡化套件管理。 如果你需要來自額外訂閱源或公開登錄檔的套件,請使用上游來源,而不是直接在每個用戶端設定中加入多個訂閱源。

  • 自動發佈新建立的套件

    自動化新套件的發布,有助於確保最新版本能直接提供給您的團隊或目標消費者,無需人工介入。 當你發佈套件時,Azure Artifacts 會將其加入@local你的訂閱視窗。 請參閱 什麼是 Feed 視圖?如需詳細資訊,請參閱

  • 啟用保留原則以自動清除舊的套件版本

    隨著時間推移,舊的套件版本會累積、佔用儲存空間,並使訂閱源更難以管理。 保留政策允許你自動移除較舊的套件版本,同時保留指定數量的最新版本。 此過程有助於控制儲存量的成長,並讓飼料更易於維護。 詳情請參見 「自動刪除套件及保留政策 」。

  • 使用摘要檢視來發行套件

    摘要檢視可讓您與使用者分享部分套件版本。 例如,你可以先將套件提升至 @prerelease,供早期採用者使用,然後在它準備好供更廣泛使用時,再將它提升至 @release。 提升至檢視的套件不受保留原則約束。 請參閱 什麼是 Feed 視圖?如需詳細資訊,請參閱

  • 確定檢視的適當存取權限

    如果你的套件被外部團隊或跨組織使用,請確保 @release@prerelease 檢視有適當的可見性設定。 如需詳細資訊,請參閱 摘要檢視設定

套件使用者的最佳做法

當你使用包裹時,目標是讓恢復變得可預測,並清楚說明包裹的來源。

  • 在用戶端組態中使用單一摘要來源

    為了幫助你的訂閱源提供確定性還原,請確保你的客戶端設定只參考一個啟用上游來源的訂閱源。 這種做法能讓你的設定檔更簡單,並降低意外套件解析結果的機率。 欲了解更多資訊,請參閱 「什麼是上游來源?」

  • 針對外部套件使用上游來源

    如果你使用外部串流或公開登錄檔(如 NuGet.orgnpmjs.com)的套件,請使用上游來源,而不是分別將這些來源加入每個用戶端配置。 這種方法讓你的團隊能透過同一來源,穩定地恢復內部與外部依賴。 欲了解更多資訊,請參閱 「什麼是上游來源?」「設定上游來源」。

    注意

    您必須是 餵流和上游讀取者(協作者) 或更高的級別,才能從上游來源儲存套件。 如需更多詳細資訊,請參閱提要角色和權限。

  • 有意識地排序上游來源

    該串流依序檢查上游來源,並從第一個包含該來源的來源回傳封包。 如果你使用多個上游來源,請依順序排列它們,讓摘要能從你預期的來源解析套件。 當你使用公開登錄檔與內部訂閱源混合使用,或是組織內部重新發布客製化開源套件時,這種排序尤其重要。 欲了解更多資訊,請參閱 「有意識地排序你的上游來源 」和 「搜尋順序」。

  • 利用動態檢視來控制消費者所看到的內容

    如果你的團隊透過訂閱檢視推廣已驗證的套件版本,請利用這些檢視只分享針對特定受眾的套件版本。 例如,您可以將新發佈的套件保留在 @local、透過 @prerelease 分享預覽版建置,並透過 @release 分享已核准的套件。

  • 在同一租戶中,使用動態定位器來顯示跨組織來源

    如果來源在同一個 Microsoft Entra 租戶裡,但不屬於你的組織,請使用訂閱源定位器。 語法是 azure-feed://<organization>/<projectName>/<feed>@<view>