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

определение steps.task

  • Статья

Шаг task выполняет задачу.

Все задачи поддерживают следующий набор общих свойств.

steps:
- task: string # Required as first property. Name of the task to run.
  inputs: # Inputs for the task.
    string: string # Name/value pairs
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.
  retryCountOnTaskFailure: string # Number of retries if the task fails.

steps:
- task: string # Required as first property. Name of the task to run.
  inputs: # Inputs for the task.
    string: string # Name/value pairs
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.

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

Свойства

строка task. Обязательный в качестве первого свойства.
имя выполняемой задачи.

inputs словарь строк.
входные данные для задачи.

строка condition.
оценить это выражение условия, чтобы определить, следует ли выполнять эту задачу.

continueOnError логические.
Продолжить работу даже при сбое?

строка displayName.
имя, доступное для чтения для задачи.

target целевой.
среда, в которой выполняется эта задача.

enabled логические.
запустить эту задачу при выполнении задания?

env словарь строк.
Переменные для сопоставления с средой процесса.

строка name.
идентификатор шага. Допустимые значения: [-_A-Za-z0-9]*.

строка timeoutInMinutes.
время ожидания завершения этой задачи до того, как сервер убьет его. Например, чтобы настроить время ожидания в 10 минут, используйте timeoutInMinutes: 10.

Примечание.

Конвейеры могут быть настроены с временем ожидания уровня задания. Если интервал времени ожидания задания истекает до завершения шага, выполнение задания (включая шаг) завершается, даже если шаг настроен с более длинным интервалом timeoutInMinutes. Дополнительные сведения см. в разделе "Время ожидания".

строка retryCountOnTaskFailure.
число повторных попыток, если задача завершается ошибкой. В Azure DevOps Server 2022, 2022.1 и 2022.2 повторные попытки поддерживаются только в заданиях агента. Дополнительные сведения см. в обновлении службы Azure DevOps 16 ноября 2021 г. — автоматическое повторение для задачи и обновлении службы Azure DevOps 14 июня 2025 г. — повторная попытка для задач сервера.

Замечания

задачи являются стандартными блоками конвейера. Существует каталог задач доступны для выбора.

Если вы не указываете режим команд, можно сократить структуру target до следующего:

- task:
  target: string  # container name or the word 'host'

Общие свойства задачи

Все задачи поддерживают набор общих свойств в дополнение к name и inputs. Список общих свойств задачи см. в предыдущем разделе Свойства. Дополнительные сведения о настройке этих свойств см. в параметрах управления задачами и переменных среды задач.

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

Примеры

steps:
- task: VSBuild@1
  displayName: Build
  timeoutInMinutes: 120
  inputs:
    solution: '**\*.sln'

См. также