Créer et gérer des pools d’agents

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Un pool d’agents est une collection d’agents. Au lieu de gérer chaque agent individuellement, vous organisez les agents en pools d’agents. Lorsque vous configurez un agent, il est inscrit auprès d’un pool unique. Lorsque vous créez un pipeline, vous spécifiez le pool dans lequel le pipeline s’exécute. Quand vous exécutez le pipeline, il s’exécute sur un agent de ce pool, répondant aux demandes du pipeline.

Les pools d’agents DevOps pools managés sont gérés dans le portail Azure. Si vous utilisez des pools DevOps managés, consultez le guide de démarrage rapide pour créer un pool.

Dans Azure Pipelines, les pools sont étendus à l’ensemble de l’organisation. Vous pouvez donc partager des machines d’agent entre des projets.

Dans Azure DevOps Server, les pools d’agents sont étendus à l’ensemble du serveur. Vous pouvez donc partager des machines d’agent entre des projets et des regroupements.

Les travaux de pool d’agents exécutent un travail sur un seul agent. Si vous devez exécuter un travail sur tous les agents, comme un groupe de déploiement pour les pipelines de mise en production classiques, consultez Groupes de déploiement d’approvisionnement.

Si vous êtes administrateur d’organisation, vous créez et gérez des pools d’agents à partir de l’onglet Pools d’agents dans les paramètres d’administration.

Connectez-vous à votre organisation (https://dev.azure.com/{yourorganization}).
Sélectionnezles paramètres de l’organisation>.
Sélectionnez Pools d’agents.

Connectez-vous à votre collection de projets (http://your-server/DefaultCollection).
Sélectionnezles paramètres de collection>.
Sélectionnez Pools d’agents.

Si vous êtes membre de l’équipe de projet, vous créez et gérez des pools d’agents à partir de l’onglet Pools d’agents dans les paramètres du projet.

Accédez à votre projet et sélectionnez Paramètres du projet>Pools d’agents.

Pools d’agents par défaut

Les pools d’agents suivants sont fournis par défaut :

Pool par défaut : utilisez-le pour inscrire des agents auto-hébergés que vous avez configurés.

Azure Pipelines : Ce pool hébergé inclut diverses images Windows, Linux et macOS. Pour obtenir la liste complète des images disponibles et des logiciels installés correspondants, consultez Agents hébergés par Microsoft.

Par défaut, tous les contributeurs d’un projet sont membres du rôle Utilisateur sur les pools hébergés. Cette désignation permet à chaque contributeur d’un projet de créer et d’exécuter des pipelines avec des agents hébergés par Microsoft.

Pour choisir un agent hébergé par Microsoft à partir du pool Azure Pipelines dans votre pipeline YAML Azure DevOps Services, spécifiez le nom de l’image à l’aide de l’étiquette d’image de machine virtuelle YAML de ce tableau.

pool:
  vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.

Pour utiliser un pool privé sans aucune demande :

pool: MyPool

Pour plus d’informations, consultez le schéma YAML pour les pools.

Gérer les pools et les files d’attente

Interface utilisateur d’Azure Pipelines
Interface CLI Azure DevOps

Les administrateurs d’organisation créent et gèrent des pools d’agents à partir de l’onglet Pools d’agents dans les paramètres d’administration.

Connectez-vous à votre organisation (https://dev.azure.com/{yourorganization}).
Sélectionnezles paramètres de l’organisation>.
Sélectionnez Pools d’agents.

Connectez-vous à votre collection de projets (http://your-server/DefaultCollection).
Sélectionnezles paramètres de collection>.
Sélectionnez Pools d’agents.

Les membres de l’équipe de projet créent et gèrent des pools d’agents à partir de l’onglet Pools d’agents dans les paramètres du projet.

Accédez à votre projet et sélectionnez Paramètres du projet>Pools d’agents.

Pour supprimer un pool, accédez à la liste des pools d’agents , puis sélectionnez Autres options>Supprimer.

Capture d’écran montrant comment supprimer un pool d’agents.

Lister les pools d’agents | Afficher les détails d’un pool d’agents | Lister les files d’attente d’agents | Afficher les détails d’une file d’attente d’agents

Remarque

Les utilisateurs peuvent afficher des informations sur les pools d’agents et les files d’attente, mais pas les modifier à l’aide d’Azure CLI.

S’il s’agit de votre première utilisation az devops pipelines de commandes, consultez Prise en main d’Azure DevOps CLI.

Lister les pools d’agents

az pipelines pool list [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]
                       [--pool-name]
                       [--pool-type {automation, deployment}]

Paramètres

action: Filtrez la liste selon les actions utilisateur autorisées. Les valeurs acceptées sont manage, noneet use.
detect: détecte automatiquement l’organisation. Les valeurs acceptées sont false et true.
org ou organization: URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Ce processus est requis s’il n’est pas configuré comme valeur par défaut ou récupéré via la configuration Git. Par exemple : https://dev.azure.com/MyOrganizationName/.
pool-name: filtrez la liste avec un nom de pool correspondant.
pool-type: filtrez la liste avec le type de pool. Les valeurs acceptées sont automation et deployment.

Exemple

L’exemple suivant répertorie tous les pools au format de tableau. Cet exemple utilise la configuration par défaut suivante : az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines pool list --output table

ID    Name                             Is hosted    Pool type
----  -------------------------------  -----------  -----------
1     Default                          False        automation
2     Hosted                           True         automation
3     Hosted VS2017                    True         automation
4     Hosted Windows 2019 with VS2019  True         automation
5     Hosted Windows Container         True         automation
6     Hosted macOS                     True         automation
7     Hosted macOS High Sierra         True         automation
8     Hosted Ubuntu 1604               True         automation
9     Azure Pipelines                  True         automation
10    MyAgentPool                      False        automation

Afficher les détails du pool d’agents

az pipelines pool show --id
                       [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]

Paramètres

id ou pool-id: ID (obligatoire) du pool pour répertorier les détails.
action: Filtrez la liste selon les actions utilisateur autorisées. Les valeurs acceptées sont manage, noneet use.
detect: détecte automatiquement l’organisation. Les valeurs acceptées sont false et true.
org ou organization: URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Ce processus est requis s’il n’est pas configuré comme valeur par défaut ou récupéré via la configuration Git. Par exemple : https://dev.azure.com/MyOrganizationName/.

Exemple

L’exemple suivant affiche les détails du pool pour le pool hébergé Windows 2019 avec VS2019. Cet exemple utilise la configuration par défaut suivante : az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines pool show --id 4

{
  "agentCloudId": 1,
  "autoProvision": true,
  "autoSize": null,

  <Some properties omitted for space>

  "poolType": "automation",
  "properties": null,
  "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
  "size": 1,
  "targetSize": 1
}

Vous pouvez également utiliser --output table, qui retourne les mêmes informations que la list commande.

az pipelines pool show --id 4 --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
4     Hosted Windows 2019 with VS2019  True         automation

Lister les files d’attente d’agents

az pipelines queue list [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--queue-name]

Paramètres

action: Filtrez la liste selon les actions utilisateur autorisées. Les valeurs acceptées sont manage, noneet use.
detect: détecte automatiquement l’organisation. Les valeurs acceptées sont false et true.
org ou organization: URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Ce processus est requis s’il n’est pas configuré comme valeur par défaut ou récupéré via la configuration Git. Par exemple : https://dev.azure.com/MyOrganizationName/.
project ou p: nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Ce processus est requis s’il n’est pas configuré comme valeur par défaut ou récupéré via la configuration Git.
queue-name: Filtrez la liste avec un regex de nom de file d’attente correspondant (par exemple, ubuntu pour une file d’attente nommée Hosted Ubuntu 1604).

Exemple

L’exemple suivant liste toutes les files d’attente au format tableau. Cet exemple utilise la configuration par défaut suivante : az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines queue list --output table
This command group is in preview. It might be changed/removed in a future release.
ID    Name                             Pool IsHosted    Pool Type
----  -------------------------------  ---------------  -----------
11    Default                          False            automation
12    Hosted                           True             automation
13    Hosted VS2017                    True             automation
14    Hosted Windows 2019 with VS2019  True             automation
15    Hosted Windows Container         True             automation
16    Hosted macOS                     True             automation
17    Hosted macOS High Sierra         True             automation
18    Hosted Ubuntu 1604               True             automation
19    Azure Pipelines                  True             automation

Afficher les détails de la file d’attente d’agents

az pipelines queue show --id
                        [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]

Paramètres

id ou queue-id: Pour obtenir des informations, ID de la file d’attente de l’agent.
action: Filtrez la liste selon les actions utilisateur autorisées. Les valeurs acceptées sont manage, noneet use.
detect: détecte automatiquement l’organisation. Les valeurs acceptées sont false et true.
org ou organization: URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Ce processus est requis s’il n’est pas configuré comme valeur par défaut ou récupéré via la configuration Git. Par exemple : https://dev.azure.com/MyOrganizationName/.
project ou p: Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Ce processus est requis s’il n’est pas configuré comme valeur par défaut ou récupéré via la configuration Git.

Exemple

L’exemple suivant affiche les détails de la file d’attente Windows 2019 hébergée avec VS2019. Il utilise la configuration par défaut suivante : az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines queue show --id 14

{
  "id": 14,
  "name": "Hosted Windows 2019 with VS2019",
  "pool": {
    "id": 4,
    "isHosted": true,
    "isLegacy": true,
    "name": "Hosted Windows 2019 with VS2019",
    "poolType": "automation",
    "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
    "size": 1
  },
  "projectId": "16836457-4ce1-4e77-b97a-e7e0c6508e84"
}

Les commandes Azure DevOps CLI ne sont pas prises en charge pour Azure DevOps Server.

Les pools sont utilisés pour exécuter des travaux. Découvrez comment spécifier des pools pour des travaux.

Si vous avez de nombreux agents auto-hébergés destinés à différentes équipes ou objectifs, vous souhaiterez peut-être créer d’autres pools. Utilisez les instructions suivantes.

Créer des pools d’agents

Voici quelques situations courantes lorsque vous souhaiterez peut-être créer des pools d’agents auto-hébergés.

Vous êtes membre d’un projet et souhaitez utiliser un ensemble d’ordinateurs que votre équipe possède pour exécuter des travaux de génération et de déploiement :

Vérifiez que vous disposez des autorisations nécessaires pour créer des pools dans votre projet. Dans les paramètres du projet, accédez au volet Pools d’agents et sélectionnez Sécurité. Pour créer des pools, vous devez avoir le rôle Administrateur .
Sélectionnez Ajouter un pool, puis sélectionnez l’option permettant de créer un pool.
Installez et configurez les agents pour qu’ils font partie du nouveau pool d’agents.

Vous êtes membre de l’équipe d’infrastructure et souhaitez configurer un pool d’agents à utiliser dans tous les projets :

Vérifiez que vous disposez des autorisations nécessaires pour créer des pools dans votre projet. Dans les paramètres de l’organisation, accédez au volet Pools d’agents et sélectionnez Sécurité.
Créez un pool d’agents et sélectionnez l’option Provisionner automatiquement ce pool d’agents dans tous les projets lorsque vous créez le pool. Ce paramètre garantit que tous les projets ont accès à ce pool d’agents.
Installez et configurez les agents pour qu’ils font partie du nouveau pool d’agents.

Vous souhaitez partager un ensemble d’ordinateurs d’agent avec certains, mais pas tous, de vos projets :

Accédez à Paramètres de l’un des projets. Ajoutez un pool d’agents, puis sélectionnez l’option permettant de créer un pool au niveau de l’organisation.
Accédez aux autres projets et créez un pool dans chacun d’eux. Sélectionnez Utiliser un pool d’agents existant à partir de l’organisation.
Installez et configurez les agents pour qu’ils font partie du pool d’agents partagés.

Vous êtes membre d’un projet et souhaitez utiliser un ensemble d’ordinateurs que votre équipe possède pour exécuter des travaux de génération et de déploiement :

Vérifiez que vous disposez des autorisations nécessaires pour créer des pools dans votre projet. Dans les paramètres du projet, accédez au volet Pools d’agents et sélectionnez Sécurité. Pour créer des pools, vous devez avoir le rôle Administrateur .
Sélectionnez Ajouter un pool, puis sélectionnez l’option permettant de créer un pool.
Installez et configurez les agents pour qu’ils font partie du nouveau pool d’agents.

Vous êtes membre de l’équipe d’infrastructure et souhaitez configurer un pool d’agents à utiliser dans tous les projets :

Vérifiez que vous disposez des autorisations nécessaires pour créer des pools dans votre projet. Dans les paramètres de l’organisation, accédez au volet Pools d’agents et sélectionnez Sécurité.
Créez un pool d’agents et sélectionnez l’option Provisionner automatiquement ce pool d’agents dans tous les projets lorsque vous créez le pool. Ce paramètre garantit que tous les projets ont accès à ce pool d’agents.
Installez et configurez les agents pour qu’ils font partie du nouveau pool d’agents.

Vous souhaitez partager un ensemble d’ordinateurs d’agent avec certains, mais pas tous, de vos projets :

Accédez à Paramètres de l’un des projets. Ajoutez un pool d’agents, puis sélectionnez l’option permettant de créer un pool au niveau de l’organisation.
Accédez aux autres projets et créez un pool dans chacun d’eux. Sélectionnez Utiliser un pool d’agents existant à partir de l’organisation.
Installez et configurez les agents pour qu’ils font partie du pool d’agents partagés.

Sécurité des pools d’agents

Lorsque vous comprenez comment la sécurité fonctionne pour les pools d’agents, vous pouvez mieux contrôler le partage et l’utilisation des agents.

Les rôles sont définis sur chaque pool d’agents. L’appartenance à ces rôles régit les opérations que vous pouvez effectuer sur un pool d’agents.

Paramètres de sécurité au niveau de l’organisation

Rôle sur un pool d’agents dans les paramètres de l’organisation	Objectif
Reader	Les membres de ce rôle peuvent afficher le pool d’agents et les agents. Vous utilisez généralement ce rôle pour ajouter des opérateurs responsables de la surveillance des agents et de leur intégrité.
Compte de service	Les membres de ce rôle peuvent utiliser le pool d’agents d’organisation pour créer un pool d’agents de projet dans un projet. Si vous suivez les instructions précédentes pour créer des pools d’agents de projet, vous n’avez généralement pas besoin d’ajouter de membres ici.
Administrateur	Outre toutes les autorisations ci-dessus, les membres de ce rôle peuvent inscrire des agents auprès du pool d’agents d’organisation ou les désinscrire. Ils peuvent également faire référence au pool d’agents de l’organisation lorsqu’ils créent un pool d’agents de projet dans un projet. Ils peuvent également gérer l'adhésion pour tous les rôles du pool d'agents de l'organisation. Un utilisateur qui crée un pool d’agents d’organisation reçoit automatiquement le rôle Administrateur pour ce pool.

Le nœud Tous les pools d’agents sous l’onglet Pools d’agents contrôle la sécurité de tous les pools d’agents de l’organisation. Les appartenances aux rôles pour les pool d’agents individuels au sein d’une organisation sont automatiquement héritées du nœud Tous les pools d’agents. Par défaut, les administrateurs du Serveur Azure DevOps sont également des administrateurs du nœud Tous les pools d’agents lors de l’utilisation de Azure DevOps Server.

Paramètres de sécurité au niveau du projet

Les rôles sont également définis sur chaque pool d’agents de projet. L’appartenance à ces rôles régit les opérations que vous pouvez effectuer sur un pool d’agents au niveau du projet.

Rôle dans un pool d’agents dans Paramètres du projet	Objectif
Reader	Les membres de ce rôle peuvent voir le pool d’agents de projet. Vous utilisez généralement ce rôle pour ajouter des opérateurs qui surveillent les travaux de génération et de déploiement dans ce pool d’agents de projet.
Utilisateur	Les membres de ce rôle peuvent utiliser le pool d’agents de projet lorsqu’ils créent des pipelines.
Administrateur	Outre toutes les opérations ci-dessus, les membres de ce rôle peuvent gérer l’appartenance à tous les rôles du pool d’agents de projet. Un utilisateur qui crée un pool d’agents d’organisation reçoit automatiquement le rôle Administrateur pour ce pool.

Autorisations de pipeline

Les autorisations de pipeline contrôlent les pipelines YAML autorisés à utiliser un pool d’agents. Les autorisations de pipeline ne limitent pas l’accès à partir de pipelines classiques.

Choisissez parmi l’un des processus suivants :

Ouvrez l’accès à tous les pipelines pour utiliser le pool d’agents à partir des options supplémentaires en haut à droite de la section Autorisations du pipeline sous l’onglet Sécurité d’un pool d’agents.
Verrouillez le pool d’agents et autorisez uniquement les pipelines YAML sélectionnés à l’utiliser. Si un autre pipeline YAML fait référence au pool d’agents, une demande d’autorisation est déclenchée, qu’un administrateur de pool d’agents doit approuver. Ce processus ne limite pas l’accès à partir de pipelines classiques.

Capture d’écran montrant l’expérience utilisateur des autorisations de pipeline pour un pool d’agents.

Les autorisations de pipeline pour le pool d’agents Azure Pipelines ne peuvent pas être configurées, car le pool est accessible à tous les pipelines par défaut.

L’action de sécurité sous l’onglet Pools d’agents contrôle la sécurité de tous les pools d’agents de projet dans un projet. Les appartenances aux rôles des pools d’agents de projet individuels sont automatiquement héritées de ce que vous définissez ici. Par défaut, les groupes suivants sont ajoutés au rôle Administrateur de tous les pools d’agents : Administrateurs de build, Administrateurs de mise en production et Administrateurs de projet.

Questions fréquentes (FAQ)

Si je ne planifie pas de fenêtre de maintenance, quand les agents exécutent-ils la maintenance ?

Si vous ne planifiez pas de fenêtre de temps, les agents de ce pool n’effectuent pas la tâche de maintenance.

Qu’est-ce qu’un travail de maintenance ?

Vous pouvez configurer des pools d’agents pour nettoyer périodiquement les dépôts et répertoires de travail obsolètes. Ce processus réduit le risque pour les agents de manquer d’espace disque. Les travaux de maintenance sont configurés au niveau de l’organisation dans les paramètres du pool d’agents .

Configurer les paramètres du travail de maintenance :

Connectez-vous à votre organisation (https://dev.azure.com/{yourorganization}).
Sélectionnezles paramètres de l’organisation>.
Sélectionnez Pools d’agents.

Connectez-vous à votre collection de projets (http://your-server/DefaultCollection).
Sélectionnezles paramètres de collection>.
Sélectionnez Pools d’agents.

Sélectionnez le pool souhaité, puis sélectionnez Paramètres pour configurer les paramètres du travail de maintenance pour ce pool d’agents.

Important

Vous devez disposer de l’autorisation Gérer les files d’attente de build pour configurer les paramètres du travail de maintenance. Si vous ne voyez pas les onglets Paramètres ou Historique de maintenance , vous n’avez pas cette autorisation, que le rôle Administrateur a par défaut. Pour plus d’informations, consultez Sécurité des pools d’agents.

Capture d’écran montrant les paramètres du travail de maintenance.

Configurez vos paramètres souhaités, puis sélectionnez Enregistrer.

Sélectionnez Historique de maintenance pour voir l’historique des travaux de maintenance pour le pool d’agents actuel. Vous pouvez télécharger et consulter les journaux pour voir les actions et les étapes de nettoyage effectuées.

Capture d’écran montrant l’historique des travaux de maintenance.

La maintenance est effectuée par pool d’agents, et non par machine. Si vous avez plusieurs pools d’agents sur un seul ordinateur, vous risquez de rencontrer des problèmes d’espace disque.

Le travail de maintenance de mon pool d’agents auto-hébergés semble bloqué. Pourquoi ?

En règle générale, un travail de maintenance est bloqué lorsqu'il est en attente d'exécution sur un agent qui n'est plus dans le pool d'agents. Par exemple, un agent était délibérément mis hors connexion, ou il existe des problèmes de communication avec celui-ci.

Les travaux de maintenance mis en file d’attente pour s’exécuter attendent sept jours pour s’exécuter. S’ils ne sont pas exécutés pendant cette période, ils sont automatiquement dans un état d’échec. Vous ne pouvez pas modifier cette limite de temps.

La limite de sept jours est différente du paramètre de délai d’expiration du travail de maintenance. Ce paramètre contrôle le nombre maximal de minutes qu’un agent peut passer à effectuer la maintenance. Le minuteur démarre quand le travail commence, et non lorsque le travail est mis en file d’attente sur un agent.

J’essaie de créer un pool d’agents de projet qui utilise un pool d’agents d’organisation existant, mais les contrôles ne sont pas disponibles. Pourquoi ?

Dans la fenêtre de dialogue Créer un pool d’agents de projet, vous ne pouvez pas utiliser un pool d’agents d’organisation existant si un autre pool d’agents de projet le référence déjà. Chaque pool d’agents d’organisation peut être référencé par un seul pool d’agents de projet au sein d’une collection de projets.

Je ne peux pas sélectionner un pool hébergé par Microsoft et je ne peux pas mettre ma build en file d’attente. Comment résoudre ce problème ?

Demandez au propriétaire de votre organisation Azure DevOps de vous accorder l’autorisation d’utiliser le pool. Consultez Sécurité des pools d’agents.

J’ai besoin de plus de ressources de build hébergées. Que puis-je faire ?

Le pool Azure Pipelines fournit à toutes les organisations Azure DevOps des agents de build hébergés dans le cloud et des minutes de génération gratuites chaque mois. Si vous avez besoin de ressources de build hébergées par Microsoft ou que vous devez exécuter plus de travaux en parallèle, vous pouvez :

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-12-17

Partager via

Créer et gérer des pools d’agents

Pools d’agents par défaut

Désigner un pool dans votre pipeline

Gérer les pools et les files d’attente

Créer des pools d’agents

Sécurité des pools d’agents

Paramètres de sécurité au niveau de l’organisation

Paramètres de sécurité au niveau du projet

Autorisations de pipeline

Questions fréquentes (FAQ)

Si je ne planifie pas de fenêtre de maintenance, quand les agents exécutent-ils la maintenance ?

Qu’est-ce qu’un travail de maintenance ?

Le travail de maintenance de mon pool d’agents auto-hébergés semble bloqué. Pourquoi ?

J’essaie de créer un pool d’agents de projet qui utilise un pool d’agents d’organisation existant, mais les contrôles ne sont pas disponibles. Pourquoi ?

Je ne peux pas sélectionner un pool hébergé par Microsoft et je ne peux pas mettre ma build en file d’attente. Comment résoudre ce problème ?

J’ai besoin de plus de ressources de build hébergées. Que puis-je faire ?

Commentaires

Ressources supplémentaires