管線小組正在將代理程式軟體從 3.x 版升級到 4.x 版（使用 .NET 8）。
升級至支援的作業系統上的 4.x 代理程式
如果您在 .NET 8支援的較新作業系統上執行自我裝載代理程式
若要手動起始更新，請參閱 更新自我裝載代理程式。
4.x 代理程序支援下列作業系統。
注意
如需操作系統的完整清單，請參閱 .NET 8 - 支援的作業系統版本。
-
Linux
- x64
- Debian 12 版
- Fedora 39 和 40
- openSUSE 15.5 和 15.6
- Red Hat Enterprise Linux 8 和 9
- SUSE 企業版 Linux 15.5
- Ubuntu 24.04、22.04、20.04
- Azure Linux 2.0
- Oracle Linux 8 和 9
- ARM64
- Debian 11 和 12
- Ubuntu 24.04、22.04、20.04
- Alpine x64
- Alpine Linux 3.17 至 3.20
- x64
-
macOS
- x64
- macOS 13.0 “Ventura”
- macOS 14.0 “Sonoma”
- macOS 15.0 “Sequoia”
- ARM64
- macOS 13.0 “Ventura”
- macOS 14.0 “Sonoma”
- macOS 15.0 “Sequoia”
- x64
-
Windows 作業系統
- 客戶端作業系統
- Windows 10
- 21H2， 1809， 1607
- Windows 11
- 23H2、22H2、21H2
- Windows 10
- 伺服器OS
- Windows Server 2012 或更高版本
- 客戶端作業系統
在不支援的作業系統上升級至 4.x 代理程式
如果您在 .NET 8 不支援的作業系統上執行自我裝載代理程式，您必須更新機器，以使用 .NET 8支援的較新支援的
自我裝載的 3.x 代理程式支援下列作業系統清單，但 .NET 8 不支援，且無法用來執行 4.x 版代理程式。
注意
如需不支援 .NET 8 的完整操作系統清單，請參閱 .NET 8 - 不支援的操作系統版本。
-
Linux
- x64
- Debian 10 和 11
- Fedora 36
- openSUSE 15
- 紅帽企業Linux 7
- SUSE 企業級 Linux 12 SP2
- Ubuntu 18.04、16.04
- 甲骨文Linux 7
- ARM64
- Debian 10 和 11
- Ubuntu 18.04
- Alpine x64
- 阿爾卑斯 Linux 3.13
- x64
-
macOS
- x64
- macOS 10.15 “Catalina”
- macOS 11.0 “Big Sur”
- ARM64
- macOS 11.0 “Big Sur”
- x64
-
Windows 作業系統
- 客戶端作業系統
- Windows 7 SP1 ESU
- Windows 8.1
- Windows 10
- Windows 11
- 客戶端作業系統
FAQ
3.x 和 4.x 代理程式之間的差異為何？
3.x 代理程式使用 .NET 6，而 4.x 代理程式則使用 .NET 8。
如何檢查我的代理程式，以查看他們是否可以升級至 4.x？
請將您的代理程式的作業系統與上一個 升級到 4.x 代理程式支援的作業系統 區段中的清單進行比較。
您也可以使用 腳本 來預測自我裝載集區中的代理程式是否能夠升級至 4.x。
代理程式中的安全性問題今後將如何修補？
一般而言，舊版代理軟體不會進行任何修補。 修補程式只會針對 4.x 代理程式完成。 不過，我們也擁有仍依賴 3.x 代理程式的 Azure DevOps Server 客戶。 因此，我們會逐案檢閱安全性問題，以決定。
當我在不支援的操作系統上時，我需要做什麼？
您現在應該移轉至 .NET 8 支援的較新作業系統。 否則，您的代理程式可能會嘗試升級，而且它將會失敗，因為 .NET 8 無法安裝在您的作業系統上。 在後續的部落格文章中，我們將發佈一些指導原則，以防止代理程式的自動升級。 不過，這只是一個臨時的解決方案，讓您有更多時間來升級您的代理機器。
如果我不再處理專案中的任何變更，我可以留在 2.x 或 3.x 代理程式上嗎？
不。 管線小組會定期將新功能新增至 Azure Pipelines，其中有些可能需要更新代理程式，即使您的管線並未明確相依於該功能。 當您依循後續文章中的指導來防止代理程式的自動更新時，該代理程式將無法用來排程流水線。 如果找不到具有必要功能的代理程式，管線執行將會失敗。
安裝 4.x 代理程式軟體之前，我是否必須安裝 .NET 8？
在安裝及設定 4.x 代理程式軟體之前，您不需要在代理程式電腦上安裝 .NET 8。 4.x 代理程式需要的所有 .NET 相依性都是代理程式本身的一部分。
如果我使用 4.x 代理程式，是否需要使用 .NET 8 來建置程式代碼？
用來執行 4.x 代理程式的 .NET 版本在代理程式安裝中是獨立的，而且不會用來建置程式代碼。 用來建置程式碼的 .NET 版本取決於管線以及您在代理程式計算機上安裝的 .NET 版本。
我使用 Azure DevOps Server，而不是 Azure DevOps Services。 這項變更是否會影響我？
Azure DevOps Server 最新版本使用 4.x 代理軟體，而較早版本則使用 3.x 代理軟體。
管線小組建議您，如果您計劃在未來跟上 Azure DevOps Server 的版本，現在就應該將您的代理機器更新至 .NET 8 所支援的較新操作系統。
Azure DevOps Server 是否支援 4.x 代理程式
Azure DevOps Server 版本支援使用該版本部署的代理程式版本。 Azure DevOps Server 最新版本使用 4.x 代理軟體，而較早版本則使用 3.x 代理軟體。
| Azure DevOps Server 版本 | 代理程式版本 |
|---|---|
| Azure DevOps Server | 4.x |
| Azure DevOps Server 2022.2 | 3.238.0 |
| Azure DevOps Server 2020.1.2 | 3.225.0 |
| Azure DevOps Server 2019.1.2 | 3.225.0 |
注意
Azure DevOps Server 2020 和更新版本將透過更新支援 4.x 代理程序軟體。 發行這些更新時，本文將會以對應的代理程式版本更新。
Azure DevOps Server 透過安全性或服務修補程式進行維護，針對產品中的現有功能提供針對性與累積的錯誤修正。 為了獲得最佳且最安全的產品體驗，我們強烈建議並建議所有客戶使用最新、最安全的 Azure DevOps Server 版本。 您可以從 Azure DevOps Server 下載頁面下載最新版本的產品。
安裝 Azure DevOps Server 更新或新版本之後，更新代理程式。
代理程式第 4 版部署的時程表為何？
代理程式 4.x 版於 2024 年 10 月發行。
當工作需要將代理程式更新為代理程式第 4 版時，會發生什麼情況？
一般而言，當工作需要較新版本的代理程式時，它會自動更新本身。 目前，雖然代理程式第 3 版會繼續更新，但我們已停用從代理程式第 3 版到代理程式第 4 版的自動更新。 啟用之後，對於與代理程式版本 4 不相容的操作系統，代理程式 3.248 版和更新版本不會嘗試自行更新至 v4 代理程式。 相反地，系統會顯示警告，告知用戶他們必須先升級操作系統：The operating system the agent is running on is <OS>, which will not be supported by the .NET 8 based v4 agent. Please upgrade the operating system of this host to ensure compatibility with the v4 agent. See https://aka.ms/azdo-pipeline-agent-version