Agentsoftware, Version 5

Das Pipelineteam aktualisiert die Agentsoftware von Version 4.x auf Version 5.x (mit .NET 10). Es wird dringend empfohlen, Ihre Agents auf Version 5.x zu aktualisieren.

Upgrade auf 5.x-Agent auf unterstützten Betriebssystemen

Wenn Sie selbst gehostete Agents auf neueren Betriebssystemen ausführen, die von .NET 10 unterstützt werden, wird das Upgrade auf die neue Agent-Version automatisch ausgeführt, wenn für features oder Aufgaben eine neuere Version der Agent-Software erforderlich ist.

Informationen zum manuellen Initiieren des Updates finden Sie unter Aktualisieren selbst gehosteter Agents.

Die folgenden Betriebssysteme werden vom 5.x-Agent unterstützt.

• Linux
  • x64
    • Debian 13 und 12
    • Fedora 44, 43 und 42
    • openSUSE Leap 16.0
    • Red Hat Enterprise Linux 10, 9 und 8
    • SUSE Enterprise Linux 16.0 und 15.7
    • Ubuntu 25.10, 24.04 und 22.04
    • Azure Linux 3.0
    • CentOS Stream 10 und 9
    • Oracle Linux 9 und 8
  • ARM64
    • Debian 13 und 12
    • Fedora 44, 43 und 42
    • Red Hat Enterprise Linux 10 und 9
    • Ubuntu 25.10, 24.04 und 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
    • Clientbetriebssystem
      • Windows 10
        • 21H2, 1809
      • Windows 11
        • 26H1, 25H2, 24H2
    • Serverbetriebssystem
      • Windows Server 2025, 2022, 2019, 2016, 2012 R2, 2012
  • ARM64 (öffentliche Vorschau)
    • Clientbetriebssystem
      • Windows 11
        • 26H1, 25H2, 24H2

Upgrade auf 5.x-Agent auf nicht unterstützten Betriebssystemen

Wenn Sie Ihre selbst gehosteten Agents auf einem Betriebssystem ausführen, das .NET 10 nicht unterstützt, müssen Sie Ihre Computer aktualisieren, um ein neueres unterstütztes Betriebssystem zu verwenden, das von .NET 10 unterstützt wird. Nach der Aktualisierung finden Sie unter Selbstgehostete Agents aktualisieren Anweisungen dazu, wie Sie Ihre Agents auf Version 5.x aktualisieren.

Die folgenden Betriebssysteme unterstützen selbst gehostete 4.x-Agents, werden jedoch nicht von .NET 10 unterstützt und können nicht zum Ausführen von Version 5.x-Agents verwendet werden.

• Linux
  • x64
    • Fedora 39 und 40
    • openSUSE 15.5 und 15.6
    • SUSE Enterprise Linux 15.5
  • Alpine x64
    • Alpine Linux 3.17 bis 3.20
• macOS
  • x64
    • macOS 13.0 "Ventura"
  • ARM64
    • macOS 13.0 "Ventura"
• Windows
  • Clientbetriebssystem
    • Windows 10
      • 1607
    • Windows 11
      • 23H2, 22H2, 21H2

FAQ

Was ist der Unterschied zwischen den 4.x- und 5.x-Agents?

Die 4.x-Agents verwenden .NET 8, und die 5.x-Agents verwenden .NET 10.

Wie kann ich überprüfen, ob meine Agents ein Upgrade auf 5.x durchführen können?

Vergleichen Sie das Betriebssystem Ihres Agents mit der unterstützten Liste aus dem vorherigen Upgrade auf 5.x-Agent im Abschnitt "Unterstützte Betriebssysteme ".

Sie können auch ein Skript verwenden, um vorherzusagen, ob die Agents in Ihren selbst gehosteten Pools ein Upgrade auf 5.x durchführen können.

Wie werden sicherheitsrelevante Probleme im Agent in Zukunft gepatcht?

Im Allgemeinen erhalten frühere Versionen der Agentsoftware keine Patches. Nur die 5.x-Agents erhalten Patches. Einige Azure DevOps Server Kunden verlassen sich jedoch weiterhin auf 4.x-Agents. Daher überprüft das Produktteam Sicherheitsprobleme auf Fall-für-Fall-Basis, um zu entscheiden.

Was muss ich tun, wenn ich ein nicht unterstütztes Betriebssystem verwende?

Migrieren Sie zu einem neueren Betriebssystem, das .NET 10 unterstützt. Andernfalls versucht Ihr Agent möglicherweise, ein Upgrade durchzuführen, und er schlägt fehl, da .NET 10 nicht auf Ihrem Betriebssystem installiert werden kann. Das Produktteam veröffentlicht einige Anleitungen in einem Nachverfolgungsblogbeitrag, der automatische Upgrades des Agents verhindert. Diese Anleitung soll jedoch nur eine temporäre Lösung sein, um Ihnen mehr Zeit zum Upgrade Ihrer Agent-Computer zu geben.

Kann ich auf 3.x- oder 4.x-Agents bleiben, wenn ich nicht mehr an Änderungen in meinem Projekt arbeite?

No. Das Pipelineteam fügt regelmäßig neue Features zu Azure Pipelines hinzu, und einige dieser Features erfordern möglicherweise ein Update an den Agent, obwohl Ihre Pipeline nicht explizit von diesem Feature abhängt. Wenn Sie automatische Upgrades des Agents mithilfe der Anleitungen in einem Nachverfolgungsblog verhindern, kann dieser Agent nicht zum Planen der Pipeline verwendet werden. Wenn kein Agent mit den erforderlichen Funktionen gefunden werden kann, schlägt die Pipelineausführung fehl.

Muss ich .NET 10 vor der Installation der 5.x-Agent-Software installieren?

Sie müssen .NET 10 nicht auf Ihrem Agentcomputer installieren, bevor Sie die 5.x-Agent-Software installieren und konfigurieren. Alle .NET Abhängigkeiten, die der 5.x-Agent benötigt, sind Teil des Agents selbst.

Muss ich meinen Code mit .NET 10 erstellen, wenn ich den 5.x-Agent verwende?

Die Version von .NET, die zum Ausführen des 5.x-Agents verwendet wird, ist in der Agent-Installation eigenständig und wird nicht verwendet, um Ihren Code zu erstellen. Die Version von .NET, die zum Erstellen Ihres Codes verwendet wird, hängt von der Pipeline und der Version oder den Versionen von .NET ab, die Sie auf Ihrem Agent-Computer installiert haben.

Ich verwende Azure DevOps Server und nicht Azure DevOps Services. Wirkt sich diese Änderung auf mich aus?

Die neueste Version von Azure DevOps Server verwendet die 4.x-Agent-Software.

Das Pipelineteam empfiehlt, Ihre Agent-Computer auf neuere Betriebssysteme zu aktualisieren, die .NET 10 ab sofort unterstützen, wenn Sie beabsichtigen, die Azure DevOps Server Versionen in Zukunft auf dem neuesten Stand zu halten.

Unterstützt Azure DevOps Server den 5.x-Agent?

Die Azure DevOps Server-Versionen unterstützen die Version des Agents, die mit dieser Version bereitgestellt wird. Die neueste Version von Azure DevOps Server verwendet die 4.x-Agent-Software.

Azure DevOps Server wird über Sicherheits- oder Wartungspatches gewartet, die gezielte kumulative Fehlerbehebungen für vorhandene Features im Produkt bereitstellen. Verwenden Sie für die beste und sicherste Produkterfahrung die neueste, sicherste Version von Azure DevOps Server. Sie können die neueste Version des Produkts von der Azure DevOps Server Downloadseite herunterladen.

Aktualisieren Sie nach der Installation eines Azure DevOps Server-Updates oder einer neuen Version Ihre Agents.

Wie lautet der Zeitplan für die Bereitstellung von Agent-Version 5?

Agent Version 5.x wird in 2026 veröffentlicht.

Was geschieht, wenn eine Aufgabe erfordert, dass ein Agent auf Agent Version 5 aktualisiert wird?

Normalerweise aktualisiert sich der Agent automatisch, wenn eine Aufgabe eine neuere Version des Agents benötigt. Während die Agentversion 4 jetzt weiterhin aktualisiert wird, ist die automatische Aktualisierung von Agent Version 4 auf Agent Version 5 deaktiviert. Nach der Aktivierung versucht agent version 4.x für Betriebssysteme, die nicht mit Agent Version 5 kompatibel sind, nicht mehr, sich auf den v5-Agent zu aktualisieren. Stattdessen wird eine Warnung angezeigt, die Benutzer darüber informiert, dass sie zuerst ein Upgrade des Betriebssystems durchführen müssen: 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