Agent-Software Version 4

Das Pipelineteam aktualisiert die Agentsoftware von Version 3.x auf Version 4.x (mit .NET 8).

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

Wenn Sie Ihre selbstgehosteten Agents unter neueren, von .NET 8 unterstützten Betriebssystemen ausführen, erfolgt das Upgrade auf die neue Agentversion automatisch.

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

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

• Linux
  • x64
    • Debian 12
    • Fedora 39 & 40
    • openSUSE 15.5 & 15.6
    • Red Hat Enterprise Linux 8 & 9
    • SUSE Enterprise 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 bis 3.20
• 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"
• Fenster
  • Clientbetriebssystem
    • Windows 10
      • 21H2, 1809, 1607
    • Windows 11
      • 23H2, 22H2, 21H2
  • Serverbetriebssystem
    • Windows Server 2012 oder höher

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

Wenn Sie Ihre selbstgehosteten Agents unter einem Betriebssystem ausführen, das von .NET 8 nicht unterstützt wird, müssen Sie Ihre Computer aktualisieren, um ein neueres unterstütztes Betriebssystem zu verwenden, das von .NET 8 unterstützt wird. Nach der Aktualisierung, siehe Aktualisieren von selbst gehosteten Agents für Anweisungen zum Aktualisieren Ihrer Agents auf die Version 4.x.

Die folgende Liste der Betriebssysteme wurde für selbst gehostete 3.x-Agents unterstützt, wird jedoch nicht von .NET 8 unterstützt und kann nicht zum Ausführen von Version 4.x-Agents verwendet werden.

• Linux
  • x64
    • Debian 10 & 11
    • Fedora 36
    • openSUSE 15
    • Red Hat Enterprise Linux 7
    • SUSE Enterprise Linux 12 SP2
    • Ubuntu 18.04, 16.04
    • Oracle Linux 7
  • ARM64
    • Debian 10 & 11
    • Ubuntu 18.04
  • Alpine x64
    • Alpine Linux 3.13
• macOS
  • x64
    • macOS 10.15 "Catalina"
    • macOS 11.0 "Big Sur"
  • ARM64
    • macOS 11.0 "Big Sur"
• Fenster
  • Clientbetriebssystem
    • Windows 7 SP1 ESU
    • Windows 8.1
    • Windows 10
      • 21H2 (E)
    • Windows 11
      • 21H2 (E) & 22H2 (E)

Häufig gestellte Fragen

Was ist der Unterschied zwischen den 3.x- und 4.x-Agenten?

Die 3.x-Agents verwenden .NET 6 und die 4.x-Agents verwenden .NET 8.

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

Vergleichen Sie das Betriebssystem Ihres Agenten mit der Liste der unterstützten Systeme aus dem vorherigen Abschnitt Upgrade auf 4.x-Agent auf unterstützten Betriebssystemen Abschnitt.

Sie können auch eine Skript um vorherzusagen, ob die Agenten in Ihren selbst gehosteten Pools in der Lage sein werden, auf 4.x zu aktualisieren.

Wie werden sicherheitsrelevante Probleme im Agent in Zukunft gepatcht?

Es werden in der Regel keine Patches für die vorherigen Versionen der Agentsoftware bereitgestellt. Die Patches werden nur für die 4.x-Agenten durchgeführt. Wir haben jedoch auch Azure DevOps Server-Kunden, die weiterhin auf 3.x-Agents vertrauen. Daher überprüfen wir die Sicherheitsprobleme auf Fallbasis, um zu entscheiden.

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

Sie sollten jetzt zu einem neueren Betriebssystem migrieren, das von .NET 8 unterstützt wird. Andernfalls kann der Agent versuchen, ein Upgrade durchzuführen, das jedoch scheitern wird, da .NET 8 nicht auf Ihrem Betriebssystem installiert werden kann. Wir werden einige Richtlinien in einem anschließenden Blogbeitrag veröffentlichen, die automatische Upgrades des Agents verhindern. Dies ist jedoch nur eine temporäre Lösung, um Ihnen mehr Zeit zum Upgrade Ihrer Agent-Computer zu geben.

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

Nein. Das Pipelineteam fügt regelmäßig neue Features zu Azure Pipelines hinzu, und einige davon 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 des Leitfadens in einem späteren Blog verhindern, kann dieser Agent nicht zum Planen der Pipeline verwendet werden. Wenn kein Agent mit den erforderlichen Funktionen gefunden werden kann, schlägt die Pipeline-Ausführung fehl.

Muss ich .NET 8 vor der Installation der 4.x-Agent-Software installieren?

Sie müssen .NET 8 nicht auf Ihrem Agentcomputer installieren, bevor Sie die 4.x-Agent-Software installieren und konfigurieren. Alle .NET-Abhängigkeiten, die der 4.x-Agent erfordert, sind Teil des Agents selbst.

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

Die Version von .NET, die zum Ausführen des 4.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, und frühere Versionen verwenden die 3.x-Agent-Software.

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

Unterstützt Azure DevOps Server den 4.x-Agenten

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, und frühere Versionen verwenden die 3.x-Agent-Software.

Azure DevOps Server wird über Sicherheits- oder Wartungspatches gewartet, die gezielte kumulative Fehlerbehebungen für vorhandene Features im Produkt bereitstellen. Für die beste und sicherste Produkterfahrung empfehlen wir dringend, dass alle Kunden die neueste, sicherste Version von Azure DevOps Server verwenden. 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 sieht der Zeitplan für die Bereitstellung von Agentversion 4 aus?

Agent Version 4.x wurde im Oktober 2024 veröffentlicht.

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

Wenn eine Aufgabe eine neuere Version des Agents erfordert, wird sie normalerweise automatisch selbst aktualisiert. Während die Agentversion 3 derzeit weiterhin aktualisiert wird, haben wir das automatische Update von Agent Version 3 auf Agent Version 4 deaktiviert. Sobald wir diese Funktion aktiviert haben, wird bei Betriebssystemen, die nicht mit der Agentenversion 4 kompatibel sind, die Agentenversion 3.248 und neuer nicht versuchen, sich auf den Agenten v4 zu aktualisieren. Stattdessen wird eine Warnung angezeigt, die Benutzer darüber informiert, dass sie zuerst das Betriebssystem aktualisieren müssen: 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