Agentprogramvara version 4

Artikel
12/16/2024

Pipelines-teamet uppgraderar agentprogramvaran från version 3.x till version 4.x (med hjälp av .NET 8).

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

Om du kör dina lokalt installerade agenter på nyare operativsystem stöds av .NET 8, uppgraderas du automatiskt till den nya agentversionen.

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

Anteckning

Se .NET 8 – Operativsystemversioner som stöds för en fullständig lista över operativsystem.

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 till 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"
Windows
- Windows 10
  - 21H2, 1809, 1607
- Windows 11
  - 23H2, 22H2, 21H2
- Serveroperativsystem
  - Windows Server 2012 eller senare

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

Om du kör dina lokalt installerade agenter på ett operativsystem som inte stöds av .NET 8 måste du uppdatera dina datorer så att de använder ett nyare operativsystem som stöds stöds av .NET 8.

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

Not

Se .NET 8 – Os-versioner som inte stöds för den fullständiga listan över operativsystem som inte har stöd för .NET 8.

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"
Windows
- Klientoperativsystem
  - Windows 7 SP1 ESU
  - Windows 8.1
  - Windows 10
    - 21H2 (E)
  - Windows 11
    - 21H2 (E) & 22H2 (E)

FAQ

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

3.x-agenterna använder .NET 6 och 4.x-agenterna använder .NET 8.

Hur kan jag kontrollera mina agenter för att se om de kan uppgradera till 4.x?

Jämför agentens operativsystem med den stödda listan från föregående avsnitt Uppgradera till 4.x-agent på stödda operativsystem.

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

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

Inga korrigeringar görs i allmänhet för de tidigare versionerna av agentprogramvaran. Korrigeringarna görs endast för 4.x-agenterna. Men vi har även Azure DevOps Server-kunder som fortfarande förlitar sig på 3.x-agenter. Därför granskar vi säkerhetsproblemen 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?

Du bör migrera till ett nyare operativsystem som stöds av .NET 8 nu. Annars kan agenten försöka uppgradera och det misslyckas eftersom .NET 8 inte kan installeras på operativsystemet. Vi publicerar några riktlinjer i ett uppföljningsblogginlägg som förhindrar automatiska uppgraderingar av agenten. Det är dock bara tänkt att vara en tillfällig lösning som ger dig lite mer tid att uppgradera dina agentdatorer.

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

Nej. Pipelines-teamet lägger regelbundet till nya funktioner i Azure Pipelines och vissa av dem 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 8 innan jag installerar 4.x-agentprogramvaran?

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

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

Den version av .NET som används för att köra 4.x-agenten är fristående i agentinstallationen och används inte för att skapa din kod. 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?

För närvarande använder de aktuella versionerna av Azure DevOps Server fortfarande 3.x-agentprogramvaran, så det finns ingen omedelbar inverkan.

Pipelines-teamet rekommenderar att du uppdaterar dina agentdatorer till nyare operativsystem som stöds av .NET 8 från och med nu, om du planerar att hålla jämna steg med Azure DevOps Server-versionerna i framtiden.

Har Azure DevOps Server stöd för 4.x-agenten

Azure DevOps Server-versioner stöder den version av agenten som distribueras med den versionen. För närvarande har de senaste Versionerna av Azure DevOps Server stöd för 3.x-agentens programvaruversioner. Mer information finns i Har Azure DevOps Server stöd för 3.x-agenten.

Not

Azure DevOps Server 2020 och senare stöder 4.x-agentprogramvaran via uppdateringar. När dessa uppdateringar släpps uppdateras den här artikeln med motsvarande agentversion.

Azure DevOps Server hanteras via säkerhets- eller underhållskorrigeringar som ger riktade kumulativa felkorrigeringar för befintliga funktioner i produkten. För bästa och säkraste produktupplevelse rekommenderar vi starkt att alla kunder använder den senaste, säkraste versionen av Azure DevOps Server. Du kan ladda ned den senaste versionen av produkten från nedladdningssidan Azure DevOps Server.

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

Vad är tidslinjen för agentversion 4-distribution?

Agentversion 4.x släpptes oktober 2024.

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

När en uppgift kräver en nyare version av agenten uppdateras den normalt automatiskt. För tillfället, medan agent version 3 fortsätter att uppdateras, har vi inaktiverat automatisk uppdatering från agent version 3 till agent version 4. När vi har aktiverat det försöker agent version 3.248 och senare inte uppdatera sig själv till v4-agenten för operativsystem som inte är kompatibla med agent version 4. 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 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

Dela via