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

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

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

Реализации

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

Замечания

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

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

pool: string

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

pool: string # Specify a private pool by name.

строка pool.

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

Замечания

Используйте этот синтаксис для указания частного пула по имени.

Примечание.

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

Примеры

Использование частного пула без требований:

pool: MyPool

пул: имя, требования, 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.
Имя пула.

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

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

Замечания

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

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

Примеры

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

pool:
  vmImage: ubuntu-latest

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

Чтобы добавить один запрос к конвейеру сборки YAML, добавьте строку demands: в раздел 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)

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

См. также

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