définition de pool.demandes

Implémentations

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.

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)

Analyse des capacités des agents

Lorsque le logiciel agent démarre, il analyse les logiciels et outils suivants et enregistre les capacités correspondantes.

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

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

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

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

• Fonctionnalités de l’agent