Определение pool.demands

  • Статья

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

Определения, ссылающиеся на это определение: пул

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

Реализация Описание
demands: string Укажите требование для частного пула.
demands: string list Укажите список требований для частного пула.

Комментарии

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

Примечание

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

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

Требования к задачам

Некоторые задачи не будут выполняться, если агент не выполняет одно или несколько требований. Например, задача сборки Visual Studio требует установки msbuild и visualstudio в агенте.

Запросы агента, введенные вручную

Может потребоваться использовать локальные агенты со специальными возможностями. Например, для конвейера может потребоваться SpecialSoftware для агентов в пуле Default . Или, если у вас есть несколько агентов с разными операционными системами в одном пуле, у вас может быть конвейер, для которых требуется агент Linux.

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

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

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)

demands: string

Укажите требование для частного пула.

demands: string # Specify a demand for a private pool.

demands Строка.

Укажите требование для частного пула.

Примеры

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

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

demands: string list

Укажите список требований для частного пула.

demands: [ string ] # Specify a list of demands for a private pool.

Типы списков

Тип Описание
строка Укажите список требований для частного пула.

Примеры

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

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

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