Partage via


définition pool.demands

Demandes (pour une piscine privée).

Définitions qui font référence à cette définition : pool

Implémentations

Implémentation Description
demandes : chaîne Spécifiez une demande pour un pool privé.
demandes : liste de chaînes Spécifiez une liste de demandes pour un pool privé.

Remarques

Utilisez les demandes pour vous assurer que les fonctionnalités dont votre pipeline a besoin sont présentes sur les agents qui l’exécutent. Les demandes sont déclarées automatiquement par les tâches ou manuellement par vous-même.

Notes

Les demandes et les fonctionnalités sont conçues pour être utilisées avec des agents autohébergés afin que les travaux puissent être mis en correspondance avec un agent qui répond à leurs demandes. Si vous avez recours à des agents hébergés par Microsoft, vous sélectionnez pour l’agent une image adaptée aux exigences du travail. Par conséquent, les fonctionnalités ne sont pas nécessaires avec ce type d’agent, bien qu’il soit possible de lui en ajouter.

Vous pouvez case activée pour la présence d’une fonctionnalité (opération Exists) ou vous pouvez case activée pour une chaîne spécifique dans une fonctionnalité (opération d’égalité). La vérification de l’existence d’une fonctionnalité (exists) et la recherche d’une chaîne spécifique dans une fonctionnalité (equals) sont les deux seules opérations prises en charge pour les demandes.

Demandes de tâche

Certaines tâches ne s’exécutent pas si une ou plusieurs demandes ne sont pas satisfaites par l’agent. Par exemple, la tâche Build Visual Studio demande que msbuild et visualstudio soient installés sur l’agent.

Demandes d’agent entrées manuellement

Vous pouvez avoir besoin d’utiliser des agents auto-hébergés avec des fonctionnalités spéciales. Par exemple, votre pipeline peut nécessiter SpecialSoftware sur les agents dans le pool Default. Ou, si vous avez plusieurs agents avec différents systèmes d’exploitation dans le même pool, vous pouvez avoir un pipeline qui nécessite un agent Linux.

Opération Exists

L’opération exists vérifie la présence d’une fonctionnalité portant le nom spécifique. La comparaison ne respecte pas la casse.

pool:
  name: MyPool
  demands: myCustomCapability # exists check for myCustomCapability

Opération égale

L’opération égale vérifie l’existence d’une fonctionnalité et, le cas échéant, vérifie sa valeur avec la valeur spécifiée. Si la fonctionnalité n’est pas présente ou si les valeurs ne correspondent pas, l’opération prend la valeur false. Les comparaisons ne respectent pas la casse.

pool:
  name: MyPool
  demands: Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Variables de l’agent en tant que fonctionnalités système

Les agents auto-hébergés ont les fonctionnalités système suivantes avec des noms similaires à ceux des variables d’agent, mais ils ne sont pas des variables et ne nécessitent pas de syntaxe de variable lors de la vérification de l’existence ou de l’égalité dans une demande.

  • Agent.Name
  • Agent.Version
  • Agent.ComputerName
  • Agent.HomeDirectory
  • Agent.OS
  • Agent.OSArchitecture
  • Agent.OSVersion (agents Windows uniquement)

demandes : chaîne

Spécifiez une demande pour un pool privé.

demands: string # Specify a demand for a private pool.

demands String.

Spécifiez une demande pour un pool privé.

Exemples

Pour ajouter une demande unique à votre pipeline de build YAML, ajoutez la ligne demands: à la section pool.

pool:
  name: Default
  demands: SpecialSoftware # exists check for SpecialSoftware

demandes : liste de chaînes

Spécifiez une liste de demandes pour un pool privé.

demands: [ string ] # Specify a list of demands for a private pool.

Types de liste

Type Description
string Spécifiez une liste de demandes pour un pool privé.

Exemples

Pour spécifier plusieurs demandes, ajoutez-en une par ligne.

pool:
  name: MyPool
  demands:
  - myCustomCapability   # exists check for myCustomCapability
  - Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Voir aussi