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