Определение пула

Ключевое слово pool указывает, какой пул будет использоваться для задания конвейера. Спецификация pool также содержит сведения о стратегии выполнения задания.

Определения, ссылающиеся на это определение: pipeline, stage.stage, jobs.job, jobs.deployment, preDeployHook, deployHook, routeTrafficHook, postRouteTrafficHook, onFailureHook, onSuccessHook

Варианты реализации решения

Реализация	Описание
pool: строка	Укажите частный пул по имени.
pool: name, demands, vmImage	Полный синтаксис для использования требований и пулов, размещенных в Майкрософт.

Комментарии

Пул можно указать на уровне конвейера, этапа или задания.

Для выполнения задания используется пул, указанный на самом низком уровне иерархии.

pool: строка

Укажите частный пул по имени, который будет использоваться для задания конвейера.

pool: string # Specify a private pool by name.

pool Строка.

Укажите частный пул по имени.

Комментарии

Используйте этот синтаксис, чтобы указать частный пул по имени.

Примечание

Если имя пула содержит пробел, заключите имя пула в одинарные кавычки, например pool: 'My pool'.

Примеры

Чтобы использовать частный пул без требований, выполните следующие действия.

pool: MyPool

pool: name, demands, vmImage

Полный синтаксис для использования требований и пулов, размещенных в Майкрософт.

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.

Свойства

name Строка.
Имя пула.

demandspool.demands.
Требования (для частного пула).

vmImage Строка.
Имя образа виртуальной машины, который вы хотите использовать; действителен только в пуле, размещенном в Майкрософт.

Комментарии

Укажите пул, размещенный в Корпорации Майкрософт, vmImage с помощью свойства .

Если имя локального пула агентов содержит пробел, заключите имя пула в одинарные кавычки, например name: 'My pool'.

Примеры

Чтобы использовать размещенный пул Майкрософт, опустите имя и укажите один из доступных размещенных образов:

pool:
  vmImage: ubuntu-latest

Требования для частного пула можно указать с помощью полного синтаксиса.

Чтобы добавить один запрос в конвейер сборки demands: YAML, добавьте строку в pool раздел .

pool:
  name: Default
  demands: SpecialSoftware # exists check for SpecialSoftware

Или, если необходимо добавить несколько требований, добавьте по одному на строку.

pool:
  name: MyPool
  demands:
  - myCustomCapability   # exists check for myCustomCapability
  - Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Проверка наличия возможности (существует) и проверка конкретной строки в возможности (равно) являются единственными двумя поддерживаемыми операциями для требований.

Операция существует

Операция существует проверяет наличие возможности с определенным именем. Сравнение выполняется без учета регистра.

pool:
  name: MyPool
  demands: myCustomCapability # exists check for myCustomCapability

Операция равно

Операция равно проверяет наличие возможности, а если она имеется, проверяет ее значение с указанным значением. Если возможность отсутствует или значения не совпадают, операция принимает значение false. В сравнениях регистр не учитывается.

pool:
  name: MyPool
  demands: Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Переменные агента как системные возможности

Локальные агенты имеют следующие системные возможности с именами, аналогичными переменным агента, но они не являются переменными и не требуют синтаксиса переменных при проверке наличия или равности в запросе.

• Agent.Name
• Agent.Version
• Agent.ComputerName
• Agent.HomeDirectory
• Agent.OS
• Agent.OSArchitecture
• Agent.OSVersion (только агенты Windows)

Дополнительные сведения см. в разделе Указание требований.

См. также раздел

• Указание требований
• Дополнительные сведения об условиях и времени ожидания.