代理軟體版本 5

管線團隊正在將代理軟體從版本 4.x 升級到 5.x（使用 .NET 10）。 我們強烈建議將您的代理程式升級到 5.x 版本。

在支援作業系統上升級至 5.x 代理程式

在將自架代理程式升級至 5.x 版本前，請確認其作業系統是否支援 .NET 10。 當某功能或任務需要更新的代理版本時，代理可以自動升級。 自動升級不會檢查作業系統是否支援 .NET 10。

若要手動起始更新，請參閱 更新自我裝載代理程式。

以下作業系統由 5.x 代理程式支援。

• Linux
  • x64
    • Debian 13 與 12
    • Fedora 44、43 和 42
    • openSUSE Leap 16.0
    • 紅帽企業版 Linux 10、9 與 8
    • SUSE 企業版 Linux 16.0 與 15.7
    • Ubuntu 25.10、24.04 和 22.04
    • Azure Linux 3.0
    • CentOS Stream 10 與 9
    • Oracle Linux 9 與 8
  • ARM64
    • Debian 13 與 12
    • Fedora 44、43 和 42
    • Red Hat Enterprise Linux 10 與 9
    • Ubuntu 25.10、24.04 和 22.04
  • Alpine x64
    • Alpine Linux 3.23、3.22、3.21
• macOS
  • x64
    • macOS 14.0 “Sonoma”
    • macOS 15.0 “Sequoia”
    • macOS 26.0 “Tahoe”
  • ARM64
    • macOS 14.0 “Sonoma”
    • macOS 15.0 “Sequoia”
    • macOS 26.0 “Tahoe”
• Windows
  • x64
    • 客戶端作業系統
      • Windows 10
        • 21H2， 1809， 1607
      • Windows 11
        • 26H1、25H2、24H2、23H2
    • 伺服器OS
      • Windows Server 2025、2022、2019、2016、2012 R2、2012
  • ARM64
    • 客戶端作業系統
      • Windows 11
        • 26H1、25H2、24H2、23H2

在不支援的作業系統上升級至 5.x 代理程式

如果你在不支援 .NET 10 的作業系統上運行自架代理程式，必須更新你的機器以使用由 .NET 10 支援的新作業系統。 更新後，請參閱 「更新自架代理」 ，了解如何將代理程式更新至 5.x 版本。

以下作業系統支援自架 4.x 代理程式，但不受 .NET 10 支援，且無法執行版本 5.x 代理程式。

• Linux
  • x64
    • Fedora 39 與 40
    • openSUSE 15.5 與 15.6
    • SUSE 企業版 Linux 15.5
  • Alpine x64
    • Alpine Linux 3.17 至 3.20
• macOS
  • x64
    • macOS 13.0 “Ventura”
  • ARM64
    • macOS 13.0 “Ventura”
• Windows
  • 客戶端作業系統
    • Windows 11
      • 22H2,21H2

FAQ

4.x 和 5.x 代理有什麼差別？

4.x 代理使用 .NET 8,5.x 代理使用 .NET 10。

我要怎麼檢查我的代理是否能升級到 5.x？

將您的代理程式作業系統與先前 「支援作業系統升級至 5.x 代理 」章節中所支援的清單進行比較。

你也可以用 腳本 預測自架池中的代理是否能升級到 5.x。

代理程式中的安全性問題今後將如何修補？

一般來說，先前版本的代理軟體不會收到修補程式。 只有 5.x 版本的代理程式會收到修補程式。 然而，仍有部分 Azure DevOps Server 客戶依賴 4.x 代理程式。 因此，產品團隊會逐案審查安全問題以進行決策。

當我使用一個不支援的作業系統時，我需要做什麼？

遷移到支援 .NET 10 的新作業系統。 否則，你的代理程式可能會嘗試升級，但因為 .NET 10 無法安裝在你的作業系統上而失敗。 產品團隊將在後續部落格文章中發布一些指引，防止代理自動升級。 不過，這些指引只是暫時的解決方案，讓你有更多時間升級代理機器。

如果我不再在專案中做任何變更，我還能繼續用 3.x 或 4.x 代理嗎？

No. 管線團隊會定期為 Azure Pipelines 新增功能，有些功能可能需要更新代理程式，即使你的管線並未明確依賴該功能。 當你依照後續文章中的指引防止代理程式自動升級時，該代理程式便無法用來排定管線執行。 若找不到具備所需能力的代理，管線執行即告失敗。

我必須先安裝 .NET 10 才能安裝 5.x 代理軟體嗎？

你不必在代理機器上安裝 .NET 10 才能安裝並設定 5.x 代理軟體。 5.x 代理所需的所有 .NET 依賴性都是代理本身的一部分。

如果我用的是 5.x agent，是不是一定要用 .NET 10 來編譯程式碼？

用來執行 5.x agent 的 .NET 版本是自包含在代理程式安裝中，不會用來編譯你的程式碼。 用來建置您程式碼的 .NET 版本取決於管線以及您在代理程式主機上已安裝的 .NET 版本或多個版本。

我使用 Azure DevOps Server，而不是 Azure DevOps Services。 此變更是否會對我造成影響？

最新版本的 Azure DevOps Server 使用 4.x 代理軟體。

管線團隊建議你從現在開始更新代理機器到支援 .NET 10 的新作業系統，如果你未來還打算跟上 Azure DevOps Server 的更新。

Azure DevOps Server 支援 5.x agent 嗎？

Azure DevOps Server 版本支援使用該版本部署的代理程式版本。 最新版本的 Azure DevOps Server 使用 4.x 代理軟體。

Azure DevOps Server 透過安全性或服務修補程式進行維護，針對產品中的現有功能提供針對性與累積的錯誤修正。 為了獲得最佳且最安全的產品體驗，請使用最新、最安全的 Azure DevOps Server。 你可以從 Azure DevOps Server 下載頁面下載最新版本的產品。

安裝 Azure DevOps Server 更新或新版本之後， 請更新您的代理程式。

代理程式版本 5 部署的時間表是什麼時候？

代理程式版本 5.x 將於 2026 年發布。

當任務需要將代理程式更新到代理程式版本 5 時會發生什麼事？

當任務需要更新的代理版本時，代理通常會自動更新自己。 自動升級不會先檢查作業系統是否支援 .NET 10，然後才將代理程式升級到 5.x。 在不支援的作業系統上，升級可能會失敗，或代理程式可能無法啟動。 在需要升級代理程式之前，先將代理的作業系統與 5.x 代理所支援的作業系統 進行比較，並在必要時升級作業系統。