Partager via

définition de pool

Le mot clé pool spécifie lequel pool à utiliser pour un travail du pipeline. Une spécification pool contient également des informations sur la stratégie du travail pour l’exécution.

Définitions qui font référence à cette définition : de pipeline , stage, jobs.job, jobs.deployment, préDeployHook , deployHook, routeTrafficHook, postRouteTrafficHook, onFailureHook, onSuccessHook

Implémentations

Implémentation Descriptif
pool : de chaîne Spécifiez un pool privé par nom.
pool : nom, demandes, vmImage Syntaxe complète pour l’utilisation des demandes et des pools hébergés par Microsoft.
Implémentation Descriptif
pool : de chaîne Spécifiez un pool privé par nom.
pool : nom, demandes Quel pool utiliser pour un travail du pipeline.

Remarques

Vous pouvez spécifier un pool au niveau du pipeline, de l’étape ou du travail.

Le pool spécifié au niveau le plus bas de la hiérarchie est utilisé pour exécuter le travail.

pool : chaîne

Spécifiez un pool privé par nom à utiliser pour un travail du pipeline.

pool: string # Specify a private pool by name.

chaîne pool.

Spécifiez un pool privé par nom.

Remarques

Utilisez cette syntaxe pour spécifier un pool privé par nom.

Remarque

Si le nom de votre pool a un espace, placez le nom du pool entre guillemets simples, comme pool: 'My pool'.

Exemples

Pour utiliser un pool privé sans aucune demande :

pool: MyPool

pool : nom, demandes, vmImage

Syntaxe complète pour l’utilisation des demandes et des pools hébergés par Microsoft.

pool:
  name: string # Name of a pool.
  demands: string | [ string ] # Demands (for a private pool).
  vmImage: string # Name of the VM image you want to use; valid only in the Microsoft-hosted pool.

Propriétés

chaîne name.
Nom d’un pool.

demands pool.demandes.
demandes (pour un pool privé).

chaîne vmImage.
Nom de l’image de machine virtuelle que vous souhaitez utiliser ; valide uniquement dans le pool hébergé par Microsoft.

pool : nom, demandes

Quel pool utiliser pour un travail du pipeline.

pool:
  name: string # Name of a pool.
  demands: string | [ string ] # Demands (for a private pool).

Propriétés

chaîne name.
Nom d’un pool.

demands pool.demandes.
demandes (pour un pool privé).

Remarques

Spécifiez un pool hébergé par Microsoft à l’aide de la propriété vmImage.

Si le nom de votre pool d’agents auto-hébergé a un espace, placez le nom du pool entre guillemets simples, comme name: 'My pool'.

Exemples

Pour utiliser un pool hébergé par Microsoft, omettez le nom et spécifiez l’une des images hébergées disponibles:

pool:
  vmImage: ubuntu-latest

Vous pouvez spécifier des demandes pour un pool privé à l’aide de la syntaxe complète.

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

Ou si vous avez besoin d’ajouter 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

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.

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)

Pour plus d’informations, consultez Spécifier les demandes.

Voir aussi