Agentsoftware versie 5

Het pijplijnteam werkt de agentsoftware bij van versie 4.x naar versie 5.x (met behulp van .NET 10). We raden u ten zeerste aan om uw agents te upgraden naar versie 5.x.

Upgrade uitvoeren naar 5.x-agent op ondersteunde besturingssystemen

Als u zelf-hostende agents uitvoert op nieuwere besturingssystemen die worden ondersteund door .NET 10, wordt de upgrade naar de nieuwe agentversie automatisch uitgevoerd als een functie of taken een nieuwere versie van de agentsoftware vereisen.

Om de update handmatig te starten, zie Zelfgehoste agents bijwerken.

De volgende besturingssystemen worden ondersteund door de 5.x-agent.

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

Upgrade uitvoeren naar 5.x-agent op niet-ondersteunde besturingssystemen

Als u uw zelf-hostende agents uitvoert op een besturingssysteem dat geen ondersteuning biedt voor .NET 10, moet u uw computers bijwerken om een nieuwer ondersteund besturingssysteem te gebruiken dat wordt ondersteund door .NET 10. Na het bijwerken raadpleegt u Zelf-gehoste agents bijwerken voor instructies voor het bijwerken van uw agents naar versie 5.x.

De volgende besturingssystemen ondersteunen zelf-hostende 4.x-agents, maar worden niet ondersteund door .NET 10 en kunnen niet worden gebruikt om versie 5.x-agents uit te voeren.

• Linux
  • x64
    • Fedora 39 en 40
    • openSUSE 15.5 en 15.6
    • SUSE Enterprise Linux 15.5
  • Alpine x64
    • Alpine Linux 3.17 tot 3.20
• macOS
  • x64
    • macOS 13.0 "Ventura"
  • ARM64
    • macOS 13.0 "Ventura"
• Windows
  • Client besturingssysteem
    • Windows 11
      • 22H2, 21H2

FAQ

Wat is het verschil tussen de agents 4.x en 5.x?

De 4.x-agents gebruiken .NET 8 en de 5.x-agents gebruiken .NET 10.

Hoe kan ik controleren of mijn agents kunnen upgraden naar 5.x?

Vergelijk het besturingssysteem van uw agent met de ondersteunde lijst van de vorige upgrade naar 5.x-agent in de sectie ondersteunde besturingssystemen .

U kunt ook een script gebruiken om te voorspellen of de agents in uw zelf-hostende pools kunnen upgraden naar 5.x.

Hoe worden beveiligingsproblemen in de agent in de toekomst gepatcht?

Over het algemeen ontvangen eerdere versies van de agentsoftware geen patches. Alleen de 5.x-agents krijgen patches. Sommige Azure DevOps Server klanten zijn echter nog steeds afhankelijk van 4.x-agents. Daarom beoordeelt het productteam beveiligingsproblemen per geval om te beslissen.

Wat moet ik doen wanneer ik een niet-ondersteund besturingssysteem heb?

Migreer naar een nieuwer besturingssysteem dat .NET 10 ondersteunt. Anders kan uw agent proberen een upgrade uit te voeren en mislukt het omdat .NET 10 niet kan worden geïnstalleerd op uw besturingssysteem. Het productteam publiceert enkele richtlijnen in een vervolgblogbericht dat automatische upgrades van de agent voorkomt. Deze richtlijnen zijn echter alleen bedoeld als tijdelijke oplossing om u meer tijd te geven om uw agentmachines te upgraden.

Kan ik 3.x- of 4.x-agents blijven gebruiken als ik niet meer aan wijzigingen in mijn project werk?

Nee. Het pijplijnteam voegt regelmatig nieuwe functies toe aan Azure-pipelines en sommige van deze functies vereisen mogelijk een update naar de agent, ook al is uw pijplijn niet expliciet afhankelijk van die functie. Wanneer u automatische upgrades van de agent voorkomt met behulp van de richtlijnen in een vervolgblog, kan die agent niet worden gebruikt om de pijplijn te plannen. Als er geen agent met de vereiste mogelijkheden kan worden gevonden, mislukt de uitvoering van de pijplijn.

Moet ik .NET 10 installeren voordat ik de 5.x-agentsoftware installeer?

U hoeft .NET 10 niet op uw agentcomputer te installeren voordat u de 5.x-agentsoftware installeert en configureert. Alle .NET afhankelijkheden die de 5.x-agent nodig heeft, maken deel uit van de agent zelf.

Moet ik mijn code bouwen met .NET 10 als ik de 5.x-agent gebruik?

De versie van .NET die wordt gebruikt om de 5.x-agent uit te voeren, bevindt zich in de agentinstallatie en wordt niet gebruikt om uw code te bouwen. De versie van .NET die wordt gebruikt om uw code te bouwen, is afhankelijk van de pijplijn en de versie of versies van .NET die u op uw agentcomputer hebt geïnstalleerd.

Ik gebruik Azure DevOps Server en niet Azure DevOps Services. Heeft deze wijziging invloed op mij?

De nieuwste versie van Azure DevOps Server maakt gebruik van de 4.x-agentsoftware.

Het pijplijnteam raadt u aan uw agentmachines bij te werken naar nieuwere besturingssystemen die vanaf nu .NET 10 ondersteunen, als u van plan bent om de Azure DevOps Server releases in de toekomst bij te houden.

Ondersteunt Azure DevOps Server de 5.x-agent?

Azure DevOps Server-versies ondersteunen de versie van de agent die met die versie is geïmplementeerd. De nieuwste versie van Azure DevOps Server maakt gebruik van de 4.x-agentsoftware.

Azure DevOps Server wordt onderhouden via beveiligings- of onderhoudspatches die gerichte cumulatieve bugfixes bieden voor bestaande functies in het product. Gebruik voor de beste en veiligste productervaring de nieuwste, veiligste versie van Azure DevOps Server. U kunt de nieuwste versie van het product downloaden vanaf de Azure DevOps Server downloadpagina.

Nadat u een Azure DevOps Server-update of nieuwe versie hebt geïnstalleerd, bijwerken uw agents.

Wat is de tijdlijn voor de implementatie van agentversie 5?

Agentversie 5.x wordt uitgebracht in 2026.

Wat gebeurt er wanneer voor een taak een agent moet worden bijgewerkt naar agent versie 5?

Normaal gesproken wordt de agent automatisch bijgewerkt wanneer voor een taak een nieuwere versie van de agent is vereist. Terwijl agentversie 4 voorlopig nog steeds wordt bijgewerkt, wordt automatisch bijwerken van agentversie 4 naar agentversie 5 uitgeschakeld. Zodra deze is ingeschakeld, probeert agentversie 4.x voor besturingssystemen die niet compatibel zijn met agentversie 5, zichzelf niet bij te werken naar de v5-agent. In plaats daarvan wordt een waarschuwing weergegeven waarin gebruikers worden geïnformeerd dat ze eerst het besturingssysteem moeten upgraden: 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