Oprogramowanie agenta w wersji 5

Zespół pipelines aktualizuje oprogramowanie agenta z wersji 4.x do wersji 5.x (z wykorzystaniem platformy .NET 10). Zdecydowanie zalecamy uaktualnienie agentów do wersji 5.x.

Uaktualnij agenta do wersji 5.x w obsługiwanych systemach operacyjnych

Jeśli korzystasz z własnych agentów w nowszych systemach operacyjnych obsługiwanych przez .NET 10, uaktualnienie do nowej wersji agenta jest automatyczne, jeśli którakolwiek funkcja lub zadania wymagają nowszej wersji oprogramowania agenta.

Aby ręcznie rozpocząć aktualizację, zobacz Aktualizowanie agentów lokalnie hostowanych.

Następujące systemy operacyjne są obsługiwane przez agenta 5.x.

• Linux
  • x64
    • Debian 13 i 12
    • Fedora 44, 43 i 42
    • openSUSE Leap 16.0
    • Red Hat Enterprise Linux 10, 9 i 8
    • SUSE Enterprise Linux 16.0 i 15.7
    • Ubuntu 25.10, 24.04 i 22.04
    • Azure Linux 3.0
    • CentOS Stream 10 i 9
    • Oracle Linux 9 i 8
  • ARM64
    • Debian 13 i 12
    • Fedora 44, 43 i 42
    • Red Hat Enterprise Linux 10 i 9
    • Ubuntu 25.10, 24.04 i 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
    • System operacyjny klienta
      • Windows 10
        • 21H2, 1809, 1607
      • Windows 11
        • 26H1, 25H2, 24H2, 23H2
    • System operacyjny serwera
      • Windows Server 2025, 2022, 2019, 2016, 2012 R2, 2012
  • ARM64
    • System operacyjny klienta
      • Windows 11
        • 26H1, 25H2, 24H2, 23H2

Uaktualnienie agenta do wersji 5.x w nieobsługiwanych systemach operacyjnych

Jeśli korzystasz z własnych agentów w systemie operacyjnym, który nie obsługuje .NET 10, musisz zaktualizować maszyny, aby korzystały z nowszego obsługiwanego systemu operacyjnego obsługiwanego przez .NET 10. Po aktualizacji zapoznaj się z tematem Aktualizowanie agentów hostowanych samodzielnie, aby uzyskać instrukcje dotyczące aktualizacji agentów do wersji 5.x.

Następujące systemy operacyjne obsługują własnych agentów 4.x, ale nie są obsługiwane przez .NET 10 i nie mogą być używane do uruchamiania agentów w wersji 5.x.

• Linux
  • x64
    • Fedora 39 i 40
    • openSUSE 15.5 i 15.6
    • SUSE Enterprise Linux 15.5
  • Alpine x64
    • Alpine Linux 3.17 do 3.20
• macOS
  • x64
    • macOS 13.0 "Ventura"
  • ARM64
    • macOS 13.0 "Ventura"
• Windows
  • System operacyjny klienta
    • Windows 11
      • 22H2, 21H2

Często zadawane pytania

Jaka jest różnica między agentami 4.x i 5.x?

Agenci 4.x używają .NET 8, a agenci 5.x używają .NET 10.

Jak sprawdzić, czy moi agenci mogą uaktualnić do wersji 5.x?

Porównaj system operacyjny agenta z listą obsługiwanych systemów operacyjnych podaną w poprzedniej sekcji Uaktualnianie agenta do wersji 5.x w obsługiwanych systemach operacyjnych.

Możesz również użyć skryptu, aby sprawdzić, czy agenci w pulach hostowanych samodzielnie mogą zostać uaktualnieni do wersji 5.x.

W jaki sposób problemy z zabezpieczeniami agenta będą poprawiane w przyszłości?

Ogólnie rzecz biorąc, poprzednie wersje oprogramowania agenta nie otrzymują poprawek. Tylko agenty 5.x otrzymują poprawki. Jednak niektórzy klienci Azure DevOps Server nadal korzystają z agentów 4.x. Dlatego zespół ds. produktu analizuje kwestie bezpieczeństwa indywidualnie, aby podjąć decyzję.

Co należy zrobić, gdy jestem w nieobsługiwanym systemie operacyjnym?

Przeprowadź migrację do nowszego systemu operacyjnego, który .NET 10 obsługuje. W przeciwnym razie agent może podjąć próbę uaktualnienia i kończy się niepowodzeniem, ponieważ nie można zainstalować .NET 10 w systemie operacyjnym. Zespół ds. produktu opublikuje wytyczne w kolejnym wpisie na blogu, które zapobiegają automatycznym aktualizacjom agenta. Jednak wskazówki te mają być tylko tymczasowym rozwiązaniem, które zapewnia więcej czasu na uaktualnienie maszyn agentów.

Czy mogę pozostać przy agentach 3.x lub 4.x, jeśli nie wprowadzam już żadnych zmian w swoim projekcie?

No. Zespół Azure Pipelines regularnie dodaje nowe funkcje do usługi Azure Pipelines, a niektóre z nich mogą wymagać aktualizacji agenta, mimo że Twój potok nie zależy bezpośrednio od danej funkcji. Gdy zablokujesz automatyczne aktualizacje agenta, korzystając ze wskazówek zawartych w kolejnym wpisie na blogu, tego agenta nie będzie można używać do harmonogramowania potoku. Jeśli nie można znaleźć agenta z wymaganymi możliwościami, wykonanie potoku nie powiedzie się.

Czy przed zainstalowaniem oprogramowania agenta 5.x należy zainstalować .NET 10?

Przed zainstalowaniem i skonfigurowaniem oprogramowania agenta 5.x nie trzeba instalować .NET 10 na maszynie agenta. Wszystkie .NET zależności wymagane przez agenta 5.x są częścią samego agenta.

Czy muszę skompilować kod przy użyciu .NET 10, jeśli używam agenta 5.x?

Wersja .NET używana do uruchamiania agenta 5.x jest samodzielna w instalacji agenta i nie jest używana do kompilowania kodu. Wersja platformy .NET używana do kompilowania kodu zależy od potoku oraz wersji lub wersji platformy .NET zainstalowanej na maszynie agenta.

Używam usługi Azure DevOps Server, a nie usługi Azure DevOps Services. Czy ta zmiana ma wpływ na mnie?

Najnowsza wersja Azure DevOps Server używa oprogramowania agenta 4.x.

Zespół ds. potoków zaleca już teraz zaktualizowanie komputerów agentów do nowszych systemów operacyjnych, które są obsługiwane przez platformę .NET 10, jeśli planujesz w przyszłości dotrzymywać kroku kolejnym wydaniom programu Azure DevOps Server.

Czy Azure DevOps Server obsługuje agenta 5.x?

Wersje usługi Azure DevOps Server obsługują wersję agenta wdrożonego w tej wersji. Najnowsza wersja Azure DevOps Server używa oprogramowania agenta 4.x.

Usługa Azure DevOps Server jest obsługiwana za pośrednictwem poprawek zabezpieczeń lub obsługi, które zapewniają ukierunkowane zbiorcze poprawki błędów dla istniejących funkcji w produkcie. Aby uzyskać najlepsze i najbezpieczniejsze środowisko produktu, użyj najnowszej, najbezpieczniejszej wersji Azure DevOps Server. Najnowszą wersję produktu można pobrać ze strony pobierania Azure DevOps Server.

Po zainstalowaniu aktualizacji lub nowej wersji usługi Azure DevOps Server zaktualizuj agentów.

Jaki jest harmonogram wdrożenia agenta w wersji 5?

Agent w wersji 5.x jest wydany w 2026 roku.

Co się stanie, gdy zadanie wymaga zaktualizowania agenta do agenta w wersji 5?

Zwykle, gdy zadanie wymaga nowszej wersji agenta, agent automatycznie aktualizuje się. Na razie, podczas gdy agent w wersji 4 jest nadal aktualizowany, automatyczna aktualizacja z agenta w wersji 4 do agenta w wersji 5 jest wyłączona. Po włączeniu tej opcji w przypadku systemów operacyjnych, które nie są zgodne z agentem w wersji 5, agent w wersji 4.x nie próbuje zaktualizować się do agenta w wersji 5. Zamiast tego jest wyświetlane ostrzeżenie informujące użytkowników, że muszą najpierw uaktualnić system operacyjny: The operating system the agent is running on is <OS>, which will not be supported by the .NET 10 based v5 agent. Please upgrade the operating system of this host to ensure compatibility with the v5 agent. See https://aka.ms/azdo-pipeline-agent-version