Partager via

définition de pool.demandes

Demandes (pour un pool privé).

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

Implémentations

Implémentation Descriptif
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 des 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 des tâches ou manuellement par vous.

Remarque

Les demandes et les capacités sont conçues pour être utilisées avec des agents autohébergés afin que les travaux soient attribués à un agent qui répond aux exigences du travail. Lorsque vous utilisez des agents hébergés par Microsoft, vous sélectionnez une image pour l’agent qui correspond aux exigences du travail. Par conséquent, bien qu’il soit possible d’ajouter des fonctionnalités à un agent hébergé par Microsoft, vous n’avez pas besoin d’utiliser des fonctionnalités avec des agents hébergés par Microsoft.

Vous pouvez vérifier la présence d’une fonctionnalité (opération Exists) ou rechercher une chaîne spécifique dans une fonctionnalité (opération Equals). La vérification de l’existence d’une fonctionnalité (existe) et la vérification d’une chaîne spécifique dans une fonctionnalité (égale) sont les deux seules opérations prises en charge pour les demandes.

Demandes de tâche

Certaines tâches ne s’exécutent pas, sauf si une ou plusieurs demandes sont satisfaites par l’agent. Par exemple, la tâche De build Visual Studio exige qu’elle msbuild soit visualstudio installée sur l’agent.

Demandes de l’agent entrées manuellement

Vous devrez peut-être utiliser des agents auto-hébergés avec des fonctionnalités spéciales. Par exemple, votre pipeline peut nécessiter SpecialSoftware sur les agents du Default pool. 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 existe vérifie la présence d’une fonctionnalité portant le nom spécifique. La comparaison n’est pas sensible à 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 d’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 aux variables d’agent, mais ils ne sont pas des variables et ne nécessitent pas de syntaxe de variable lors de la vérification d’existences ou égales à la 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.

chaîne demands.

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 listes

Catégorie Descriptif
ficelle Spécifiez une liste de demandes pour un pool privé.

Exemples

Pour spécifier plusieurs demandes, ajoutez 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