définition de pool

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

Définitions qui référencent cette définition : pipeline, stages.stage, jobs.job, jobs.deployment, preDeployHook, deployHook, routeTrafficHook, postRouteTrafficHook, onFailureHook, onSuccessHook

Implémentations

Implémentation	Description
pool : chaîne	Spécifiez un pool privé par son nom.
pool : name, demands, vmImage	Syntaxe complète pour l’utilisation des demandes et des pools hébergés par Microsoft.

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 son nom à utiliser pour un travail du pipeline.

pool: string # Specify a private pool by name.

pool String.

Spécifiez un pool privé par son nom.

Remarques

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

Notes

Si le nom de votre pool contient 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 : name, demands, 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

name String.
Nom d’un pool.

demandspool.demands.
Demandes (pour une piscine privée).

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

Remarques

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

Si le nom de votre pool d’agents auto-hébergés contient un espace, placez le nom du pool entre guillemets simples, par exemple 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-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

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.

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)

Pour plus d’informations, consultez Spécification des demandes.

Voir aussi

• Spécifier des demandes
• En savoir plus sur les conditions et les délais d’expiration.