Agentprogramvaran version 5

Pipelines-teamet uppgraderar agentprogramvaran från version 4.x till version 5.x (med .NET 10). Vi rekommenderar starkt att du uppgraderar dina agenter till version 5.x.

Uppgradera till 5.x-agent på operativsystem som stöds

Om du kör lokalt installerade agenter på nyare operativsystem som stöds av .NET 10, är uppgraderingen till den nya agentversionen automatisk om någon funktion eller uppgifter kräver en nyare version av agentprogramvaran.

Information om hur du initierar uppdateringen manuellt finns i Uppdatera lokalt installerade agenter.

Följande operativsystem stöds av 5.x-agenten.

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

Uppgradera till 5.x-agent på operativsystem som inte stöds

Om du kör dina lokalt installerade agenter på ett operativsystem som inte stöder .NET 10 måste du uppdatera dina datorer så att de använder ett nyare operativsystem som stöds av .NET 10. När du har uppdaterat kan du läsa Uppdatera lokalt installerade agenter för instruktioner om hur du uppdaterar dina agenter till 5.x-versionen.

Följande operativsystem stöder lokalt installerade 4.x-agenter, men stöds inte av .NET 10 och kan inte användas för att köra version 5.x-agenter.

• Linux
  • x64
    • Fedora 39 och 40
    • openSUSE 15.5 och 15.6
    • SUSE Enterprise Linux 15.5
  • Alpine x64
    • Alpine Linux 3.17 till 3.20
• macOS
  • x64
    • macOS 13.0 "Ventura"
  • ARM64
    • macOS 13.0 "Ventura"
• Windows
  • Klientoperativsystem
    • Windows 11
      • 22H2, 21H2

FAQ

Vad är skillnaden mellan 4.x- och 5.x-agenterna?

4.x-agenterna använder .NET 8 och 5.x-agenterna använder .NET 10.

Hur kan jag kontrollera om mina agenter kan uppgradera till 5.x?

Jämför agentens operativsystem med listan över operativsystem som stöds i föregående avsnitt Uppgradera till 5.x-agent på operativsystem som stöds.

Du kan också använda ett skript för att förutsäga om agenterna i dina lokala pooler kan uppgradera till 5.x.

Hur kommer säkerhetsproblem i agenten att korrigeras framöver?

I allmänhet tar tidigare versioner av agentprogramvaran inte emot korrigeringar. Endast 5.x-agenterna får korrigeringar. Vissa Azure DevOps Server kunder är dock fortfarande beroende av 4.x-agenter. Produktteamet granskar därför säkerhetsproblem från fall till fall för att avgöra.

Vad behöver jag göra när jag använder ett operativsystem som inte stöds?

Migrera till ett nyare operativsystem som .NET 10 stöder. Annars kan agenten försöka uppgradera och det misslyckas eftersom .NET 10 inte kan installeras på operativsystemet. Produktteamet publicerar viss vägledning i ett uppföljningsblogginlägg som förhindrar automatiska uppgraderingar av agenten. Den vägledningen är dock bara avsedd att vara en tillfällig lösning som ger dig mer tid att uppgradera dina agentdatorer.

Kan jag stanna på 3.x- eller 4.x-agenter om jag inte längre arbetar med några ändringar i mitt projekt?

No. Pipelines-teamet lägger regelbundet till nya funktioner i Azure-pipelines, och vissa av dessa funktioner kan kräva en uppdatering av agenten även om din pipeline inte uttryckligen är beroende av den funktionen. När du förhindrar automatiska uppgraderingar av agenten med hjälp av vägledningen i en uppföljningsblogg kan agenten inte användas för att schemalägga pipelinen. Om ingen agent med de nödvändiga funktionerna kan hittas misslyckas pipelinekörningen.

Måste jag installera .NET 10 innan jag installerar 5.x-agentprogramvaran?

Du behöver inte installera .NET 10 på din agentdator innan du installerar och konfigurerar 5.x-agentprogramvaran. Alla .NET beroenden som 5.x-agenten kräver är en del av själva agenten.

Måste jag skapa min kod med .NET 10 om jag använder 5.x-agenten?

Versionen av .NET som används för att köra 5.x-agenten är fristående i agentinstallationen och används inte för att skapa koden. Vilken version av .NET som används för att skapa koden beror på vilken pipeline och vilken version eller vilka versioner av .NET du har installerat på agentdatorn.

Jag använder Azure DevOps Server och inte Azure DevOps Services. Påverkar den här ändringen mig?

Den senaste versionen av Azure DevOps Server använder 4.x-agentprogramvaran.

Pipelines-teamet rekommenderar att du uppdaterar dina agentdatorer till nyare operativsystem som .NET 10 har stöd för från och med nu, om du planerar att följa Azure DevOps Server versioner i framtiden.

Stöder Azure DevOps Server 5.x-agenten?

Azure DevOps Server-versioner stöder den version av agenten som distribueras med den versionen. Den senaste versionen av Azure DevOps Server använder 4.x-agentprogramvaran.

Azure DevOps Server hanteras via säkerhets- eller underhållskorrigeringar som ger riktade kumulativa felkorrigeringar för befintliga funktioner i produkten. Använd den senaste och säkraste versionen av Azure DevOps Server för bästa och säkraste produktupplevelse. Du kan ladda ned den senaste versionen av produkten från Azure DevOps Server nedladdningssida.

När du har installerat en Azure DevOps Server-uppdatering eller en ny version uppdaterar du dina agenter.

Vilken är tidslinjen för agentversion 5-distribution?

Agentversion 5.x släpps 2026.

Vad händer när en uppgift kräver att en agent uppdateras till agentversion 5?

Normalt uppdateras agenten automatiskt när en uppgift kräver en nyare version av agenten. För tillfället, medan agent version 4 fortsätter att uppdateras, inaktiveras automatisk uppdatering från agent version 4 till agent version 5. När den är aktiverad försöker agent version 4.x inte uppdatera sig själv till v5-agenten för operativsystem som inte är kompatibla med agent version 5. I stället visas en varning som informerar användarna om att de behöver uppgradera operativsystemet först: 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