Partager via

Logiciel agent version 4

  • Article

L’équipe pipelines met à niveau le logiciel agent de la version 3.x vers la version 4.x (à l’aide de .NET 8).

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

Si vous exécutez vos agents auto-hébergés sur des systèmes d’exploitation plus récents pris en charge par .NET 8, la mise à niveau vers la nouvelle version de l’agent est automatique.

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

Remarque

Consultez .NET 8 - Versions de système d’exploitation prises en charge pour obtenir la liste complète des systèmes d’exploitation.

  • 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
  • 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
    • Système d’exploitation du serveur
      • Windows Server 2012 ou version ultérieure

Mettre à niveau vers l’agent 4.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 n’est pas pris en charge par .NET 8, vous devez mettre à jour vos machines pour utiliser un système d’exploitation plus récent pris en charge pris en charge par .NET 8.

La liste suivante des systèmes d’exploitation a été prise en charge pour les agents auto-hébergés 3.x, mais elles ne sont pas prises en charge par .NET 8 et ne peuvent pas être utilisées pour exécuter les agents version 4.x.

Remarque

Consultez .NET 8 - Versions hors support du système d’exploitation pour obtenir la liste complète des systèmes d’exploitation qui ne sont pas pris en charge pour .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
  • macOS
    • x64
      • macOS 10.15 « Catalina »
      • macOS 11.0 « Big Sur »
    • ARM64
      • macOS 11.0 « Big Sur »
  • Windows

FAQ

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

Les agents 3.x utilisent .NET 6 et les agents 4.x utilisent .NET 8.

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

Comparez le système d’exploitation de votre agent avec la liste des systèmes pris en charge mentionnée dans la section précédente Mise à niveau vers l’agent 4.x sur les 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 pourront effectuer une mise à niveau vers la version 4.x.

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

Aucun correctif n’est effectué, en général, pour les versions précédentes du logiciel de l’agent. Les correctifs seront effectués uniquement pour les agents 4.x. Toutefois, nous avons également des clients Azure DevOps Server qui s’appuieront toujours sur des agents 3.x. Nous allons donc examiner 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 ?

Vous devez migrer vers un système d’exploitation plus récent pris en charge par .NET 8 maintenant. Dans le cas contraire, votre agent peut tenter de procéder à la mise à niveau et échouera, car .NET 8 ne peut pas être installé sur votre système d’exploitation. Nous publierons des conseils dans un billet de blog de suivi qui empêchera les mises à niveau automatiques de l’agent. Toutefois, il s’agit uniquement d’une solution temporaire pour vous donner le temps de mettre à niveau vos ordinateurs agents.

Puis-je rester sur les agents 2.x ou 3.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 d’entre elles 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 8 avant d’installer le logiciel de l’agent 4.x ?

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

Dois-je générer mon code à l’aide de .NET 8 si j’utilise l’agent 4.x ?

La version de .NET utilisée pour exécuter l’agent 4.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 ?

À ce stade, les versions actuelles d’Azure DevOps Server utilisent toujours le logiciel de l’agent 3.x. Il n’y a donc aucun impact immédiat.

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

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

Les versions d’Azure DevOps Server prennent en charge la version de l’agent déployée avec cette version. Actuellement, les dernières versions d’Azure DevOps Server prennent en charge les versions logicielles de l’agent 3.x. Pour plus d’informations, consultez Azure DevOps Server prend en charge l’agent 3.x.

Remarque

Azure DevOps Server 2020 et versions ultérieures prennent en charge les logiciels de l’agent 4.x via les mises à jour. Lorsque ces mises à jour sont publiées, cet article est mis à jour avec la version de l’agent correspondante.

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, nous encourageons vivement et recommandons à tous les clients d’utiliser la dernière version sécurisée d’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 4 ?

La version 4.x de l’agent a été publiée en octobre 2024.

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

Normalement, lorsqu’une tâche nécessite une version plus récente de l’agent, elle se met automatiquement à jour. Pour l’instant, alors que l’agent version 3 continue d’être mise à jour, nous avons désactivé la mise à jour automatique de l’agent version 3 vers la version 4 de l’agent. Une fois que nous l’avons activé, pour les systèmes d’exploitation qui ne sont pas compatibles avec l’agent version 4, l’agent version 3.248 et les versions ultérieures ne tenteront pas de se mettre à jour vers l’agent v4. Au lieu de cela, un avertissement s’affiche pour informer les 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 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