Partager via


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 font référence à cette définition : pipeline, jobs.job

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.
Implémentation Description
pool : chaîne Spécifiez un pool privé par son nom.
pool : nom, demandes Pool à utiliser pour un travail du pipeline.

Remarques

Dans Azure DevOps Server 2019, vous pouvez spécifier un pool au niveau du travail dans YAML et au niveau du pipeline dans l’interface utilisateur des paramètres du pipeline. Dans Azure DevOps Server 2019.1, vous pouvez également spécifier un pool au niveau du pipeline dans YAML si vous avez un seul travail implicite.

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.

pool : nom, demandes

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

name String.
Nom d’un pool.

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

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