Logiciel agent version 5

L’équipe pipelines met à niveau le logiciel d’agent de la version 4.x vers la version 5.x (à l’aide de .NET 10). Nous vous recommandons vivement de mettre à niveau vos agents vers la version 5.x.

Mettre à niveau vers l’agent 5.x sur les systèmes d’exploitation pris en charge

Si vous exécutez des agents auto-hébergés sur des systèmes d'exploitation plus récents pris en charge par .NET 10, la mise à niveau vers la nouvelle version de l'agent est automatique si des fonctionnalités ou des tâches nécessitent une version plus récente du logiciel de l'agent.

Pour lancer manuellement la mise à jour, consultez Mettre à jour les agents auto-hébergés.

Les systèmes d’exploitation suivants sont pris en charge par l’agent 5.x.

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

Mettre à niveau vers l’agent 5.x sur des systèmes d’exploitation non pris en charge

Si vous exécutez vos agents auto-hébergés sur un système d'exploitation qui ne prend pas en charge .NET 10, vous devez mettre à jour vos machines pour utiliser un système d'exploitation plus récent pris en charge par .NET 10. Après la mise à jour, consultez Mettre à jour les agents auto-hébergés pour obtenir des instructions sur la façon de mettre à jour vos agents vers la version 5.x.

Les systèmes d'exploitation suivants prennent en charge les agents auto-hébergés 4.x, mais ne sont pas pris en charge par .NET 10 et ne peuvent pas être utilisés pour exécuter les agents version 5.x.

• Linux
  • x64
    • Fedora 39 et 40
    • openSUSE 15.5 et 15.6
    • SUSE Enterprise Linux 15.5
  • Alpine x64
    • Alpine Linux 3.17 à 3.20
• macOS
  • x64
    • macOS 13.0 « Ventura »
  • ARM64
    • macOS 13.0 « Ventura »
• Windows
  • Système d’exploitation client
    • Windows 11
      • 22H2, 21H2

FAQ

Quelle est la différence entre les agents 4.x et 5.x ?

Les agents 4.x utilisent .NET 8 et les agents 5.x utilisent .NET 10.

Comment puis-je vérifier si mes agents peuvent effectuer une mise à niveau vers 5.x ?

Comparez le système d’exploitation de votre agent avec la liste des systèmes d’exploitation pris en charge dans la section précédente Mettre à niveau vers l’agent 5.x sur des systèmes d’exploitation pris en charge.

Vous pouvez également utiliser un script pour prédire si les agents de vos pools auto-hébergés peuvent effectuer une mise à niveau vers 5.x.

Comment les problèmes de sécurité de l’agent seront-ils corrigés à l’avenir ?

En général, les versions précédentes du logiciel d’agent ne reçoivent pas de correctifs. Seuls les agents 5.x bénéficient de correctifs. Toutefois, certains clients Azure DevOps Server s’appuient toujours sur des agents 4.x. Ainsi, l’équipe produit examine les problèmes de sécurité au cas par cas pour décider.

Que dois-je faire quand je suis sur un système d’exploitation non pris en charge ?

Migrez vers un système d’exploitation plus récent qui .NET 10 prend en charge. Dans le cas contraire, votre agent peut tenter de mettre à niveau, et il échoue, car .NET 10 ne peut pas être installé sur votre système d'exploitation. L’équipe produit publiera des conseils dans un billet de blog de suivi qui empêche les mises à niveau automatiques de l’agent. Toutefois, ces conseils ne constituent qu’une solution temporaire pour vous donner le temps de mettre à niveau vos ordinateurs agents.

Puis-je rester sur les agents 3.x ou 4.x si je ne travaille plus sur les modifications apportées à mon projet ?

Non. L'équipe de pipelines ajoute régulièrement de nouvelles fonctionnalités à Azure Pipelines, et certaines de ces fonctionnalités peuvent nécessiter une mise à jour de l'agent même si votre pipeline ne dépend pas explicitement de cette fonctionnalité. Lorsque vous empêchez les mises à niveau automatiques de l’agent à l’aide des instructions d’un blog de suivi, cet agent ne peut pas être utilisé pour planifier le pipeline. Si aucun agent avec les fonctionnalités requises n’est disponible, l’exécution du pipeline échoue.

Dois-je installer .NET 10 avant d’installer le logiciel de l’agent 5.x ?

Vous n'avez pas besoin d'installer .NET 10 sur votre ordinateur agent avant d'installer et de configurer le logiciel de l'agent 5.x. Toutes les dépendances .NET requises par l’agent 5.x font partie de l’agent lui-même.

Dois-je générer mon code à l'aide de .NET 10 si j'utilise l'agent 5.x ?

La version de .NET utilisée pour exécuter l'agent 5.x est autonome dans l'installation de l'agent et n'est pas utilisée pour générer votre code. La version de .NET utilisée pour générer votre code dépend du pipeline et de la version ou des versions de .NET que vous avez installées sur votre ordinateur agent.

J’utilise Azure DevOps Server et non Azure DevOps Services. Ce changement m’a-t-il un impact ?

La dernière version de Azure DevOps Server utilise le logiciel de l’agent 4.x.

L’équipe de pipelines vous recommande de mettre à jour vos ordinateurs d’agent vers des systèmes d’exploitation plus récents qui .NET 10 prend en charge maintenant, si vous envisagez de suivre les versions de Azure DevOps Server à l’avenir.

Azure DevOps Server prend-il en charge l’agent 5.x ?

Les versions d’Azure DevOps Server prennent en charge la version de l’agent déployée avec cette version. La dernière version de Azure DevOps Server utilise le logiciel de l’agent 4.x.

Azure DevOps Server est pris en charge par le biais de correctifs de sécurité ou de maintenance qui fournissent des correctifs de bogues cumulatifs ciblés pour les fonctionnalités existantes du produit. Pour une expérience de produit optimale et la plus sécurisée, utilisez la version la plus récente et la plus sécurisée de Azure DevOps Server. Vous pouvez télécharger la dernière version du produit à partir de la page de téléchargement Azure DevOps Server.

Après avoir installé une mise à jour d’Azure DevOps Server ou une nouvelle version, vous devez mettre à jour vos agents.

Quelle est la chronologie du déploiement de l’agent version 5 ?

La version 5.x de l’agent est publiée en 2026.

Que se passe-t-il lorsqu’une tâche exige qu’un agent soit mis à jour vers la version 5 de l’agent ?

Normalement, lorsqu’une tâche nécessite une version plus récente de l’agent, l’agent se met automatiquement à jour. Pour l’instant, alors que l’agent version 4 continue d’être mise à jour, la mise à jour automatique de l’agent version 4 vers la version 5 de l’agent est désactivée. Une fois activé, pour les systèmes d’exploitation qui ne sont pas compatibles avec l’agent version 5, l’agent version 4.x ne tente pas de se mettre à jour vers l’agent v5. Au lieu de cela, un avertissement indique aux utilisateurs qu’ils doivent d’abord mettre à niveau le système d’exploitation : 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