Share via


Agent softwareversie 3

Het pijplijnteam werkt de agentsoftware bij van versie 2.x (met .NET Core 3.1) naar versie 3.x (met .NET 6). De nieuwe agentversie ondersteunt nieuwe Apple silicon-hardware en nieuwere besturingssystemen zoals Ubuntu 22.04 of Windows op ARM64.

Notitie

Deze functie is beschikbaar vanaf Azure DevOps Server 2022.1.

Upgrade uitvoeren naar 3.x-agent op ondersteunde besturingssystemen

Als u uw zelf-hostende agents uitvoert op nieuwere besturingssystemen die door .NET 6 worden ondersteund, wordt de upgrade naar de nieuwe agentversie automatisch uitgevoerd.

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

  • Linux
    • x64
      • Debian 10+
      • Fedora 36+
      • openSUSE 15+
      • Red Hat Enterprise Linux 7+
        • Er is geen afzonderlijk pakket meer vereist
      • SUSE Enterprise Linux 12 SP2 of hoger
      • Ubuntu 22.04, 20.04, 18.04, 16.04
      • Azure Linux 2.0
      • Oracle Linux 7 en hoger
    • ARM64
      • Debian 10+
      • Ubuntu 22.04, 20.04, 18.04
    • Alpine x64
  • MacOS
    • x64
      • macOS 10.15 "Catalina"
      • macOS 11.0 "Big Sur"
      • macOS 12.0 "Monterey"
      • macOS 13.0 "Ventura"
      • macOS 14.0 "Sonoma"
    • ARM64
      • macOS 11.0 "Big Sur"
      • macOS 12.0 "Monterey"
      • macOS 13.0 "Ventura"
      • macOS 14.0 "Sonoma"
  • Windows
    • Client-besturingssysteem
      • Windows 7 SP1 ESU
      • Windows 8.1
      • Windows 10
      • Windows 11
    • Server-besturingssysteem
      • Windows Server 2012 of hoger

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

Als u uw zelf-hostende agents uitvoert op een besturingssysteem dat niet wordt ondersteund door .NET 6, moet u uw computers bijwerken om een nieuwer ondersteund besturingssysteem te gebruiken dat wordt ondersteund door .NET 6.

De volgende lijst met besturingssystemen wordt vaak gebruikt voor zelf-hostende 2.x-agents. Deze besturingssystemen worden niet ondersteund door .NET 6 en kunnen niet worden gebruikt om de nieuwe .NET 6-agent versie 3.x uit te voeren.

Systeem/distributie Versie niet ondersteund door .NET 6
Debian <= 4,9
Fedora <= 32
Red Hat Enterprise Linux <= 6
Ubuntu < 18.04 LTS
macOS < 10.15

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

Wanneer u pijplijnen probeert uit te voeren op agentversie 2.218 (of 2.214 op RHEL 6), mislukken pijplijnen die worden uitgevoerd op een van de hier vermelde niet-ondersteunde besturingssystemen, met het volgende foutbericht: This operating system will stop receiving updates of the Pipelines Agent in the future. To be able to continue to run pipelines please upgrade the operating system or set an environment variable or agent knob "AGENT_ACKNOWLEDGE_NO_UPDATES" to "true". See https://aka.ms/azdo-pipeline-agent-v2-eos for more information.

U kunt deze fout als volgt oplossen:

  1. Werk uw agentmachines bij of verplaats deze naar een van de ondersteunde besturingssystemen die eerder in dit artikel zijn vermeld. Dit is de voorkeursoplossing en stelt u in staat toekomstige agentupdates op te halen.
  2. Stel een AGENT_ACKNOWLEDGE_NO_UPDATES variabele in op de agent door een omgevingsvariabele of een pijplijnvariabele in te stellen.
  • U kunt instellen AGENT_ACKNOWLEDGE_NO_UPDATES door een omgevingsvariabele op de agent te configureren, bijvoorbeeld in /etc/environment of etc/profile.d: AGENT_ACKNOWLEDGE_NO_UPDATES=true.

  • U kunt een pijplijnvariabele instellen.

    jobs:
    - job: 'agentWithVariables'
      displayName: 'Agent with variables'
    
      variables:
        AGENT_ACKNOWLEDGE_NO_UPDATES: 'true' # Required to not fail job on operating system that is not supported by .NET 6
    

Veelgestelde vragen

Wat is het verschil tussen de agents 2.x en 3.x?

De 2.x-agents (bijvoorbeeld 2.212) zijn .NET Core 3.1 en de 3.x-agents (bijvoorbeeld 3.212) zijn .NET 6. Tijdens fase I en II zijn beide versies beschikbaar, waarbij de 3.x-versies vooraf beschikbaar zijn.

Hoe kan ik mijn agents controleren om te zien of ze kunnen upgraden naar 3.x?

U kunt een script gebruiken om te voorspellen of de agents in uw zelf-hostende pools een upgrade kunnen uitvoeren van 2.x naar 3.x.

Hoe worden beveiligingsproblemen in de agent in de toekomst gepatcht?

Wanneer de .NET 6-agent algemeen beschikbaar wordt voor zelf-hostende pools in Q1 2023, worden er in het algemeen geen patches uitgevoerd voor de 2.x-agents. De patches worden alleen uitgevoerd voor de 3.x-agents. We hebben echter ook Azure DevOps Server-klanten die nog steeds afhankelijk zijn van 2.x-agents. Daarom bekijken we de beveiligingsproblemen per geval om te beslissen.

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

U moet nu migreren naar een nieuwer besturingssysteem dat nu wordt ondersteund door .NET 6. Anders kan uw agent proberen een upgrade uit te voeren en mislukt het omdat .NET 6 niet kan worden geïnstalleerd op uw besturingssysteem. We publiceren enkele richtlijnen in een vervolgblogbericht waarmee automatische upgrades van de agent worden voorkomen. Dit is echter alleen bedoeld om een tijdelijke oplossing te zijn om u wat meer tijd te geven om uw agentmachines te upgraden.

Kan ik op 2.x-agents blijven als ik niet meer aan wijzigingen in mijn project werk?

Nee Het pijplijnteam voegt regelmatig nieuwe functies toe aan Azure Pipelines en sommige hiervan 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 met behulp van de richtlijnen in een vervolgblog voorkomt, 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 6 installeren voordat ik de 3.x-agentsoftware installeer?

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

Moet ik mijn code bouwen met .NET 6 als ik de 3.x-agent gebruik?

De versie van .NET die wordt gebruikt om de 3.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 Service. Heeft deze wijziging invloed op mij?

Ja, als u een van de versies van Azure DevOps Server gebruikt die in de volgende sectie worden vermeld.

Het pijplijnteam raadt u aan uw agentmachines bij te werken naar nieuwere besturingssystemen die vanaf nu door .NET 6 worden ondersteund, als u van plan bent om in de toekomst bij te blijven met de Azure DevOps Server-releases.

Biedt Azure DevOps Server ondersteuning voor de 3.x-agent

Azure DevOps Server-versies ondersteunen de versie van de agent die met die versie is geïmplementeerd. De volgende versies van Azure DevOps Server bevatten een versie van de 3.x-agent die wordt ondersteund voor die Versie van Azure DevOps Server. Als u de 3.x-agent wilt installeren in uw Azure DevOps Server-installatie, werkt u uw Azure DevOps Server-versie bij naar een van de volgende versies.

Wat is de tijdlijn voor de implementatie van agentversie 3?

Agent versie 3 is uitgebracht in maart 2023.

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

Wanneer voor een taak een nieuwere versie van de agent is vereist, wordt deze normaal gesproken automatisch bijgewerkt. Terwijl agentversie 2 voorlopig nog steeds wordt bijgewerkt, hebben we automatische updates uitgeschakeld van agentversie 2 naar agentversie 3. Zodra dit is ingeschakeld, wordt voor besturingssystemen die niet compatibel zijn met agentversie 3, agentversie 2.217 en nieuwer niet geprobeerd zichzelf bij te werken naar de v3-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 6 based v3 agent. Please upgrade the operating system of this host to ensure compatibility with the v3 agent. See https://aka.ms/azdo-pipeline-agent-version