Поделиться через


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

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

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

Определения, ссылающиеся на это определение: pipeline, jobs.job

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

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

Комментарии

В Azure DevOps Server 2019 можно указать пул на уровне задания в YAML и на уровне конвейера в пользовательском интерфейсе параметров конвейера. В Azure DevOps Server 2019.1 можно также указать пул на уровне конвейера в YAML, если у вас есть одно неявное задание.

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

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

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 Строка.
Имя образа виртуальной машины, который вы хотите использовать; действителен только в пуле, размещенном в Майкрософт.

пул: имя, требования

Какой пул следует использовать для задания конвейера.

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

Свойства

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

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

Комментарии

Укажите пул, размещенный в Корпорации Майкрософт, 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)

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

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