Типы задач и использование

В YAML укажите основную версию с помощью @ имени задачи. Например, чтобы использовать версию PublishTestResults 2 задачи, укажите PublishTestResults@2. Можно указать, какую дополнительную версию использовать, указав полный номер версии задачи после @, например GoTool@0.3.1.

В классических конвейерах каждая задача имеет селектор версий , чтобы выбрать нужную версию. Рассмотрите возможность клонирования конвейера и тестирования клонированного конвейера с новыми основными версиями задач. Если выбрать предварительную версию, например 1.* Preview, версия по-прежнему находится в процессе разработки и может возникнуть проблемы.

Если вы измените версию и у вас возникнут проблемы со сборками, вы можете вернуть изменения конвейера на вкладке "Журнал". Для релизных конвейеров возможность отката к более ранней версии недоступна. Необходимо вручную вернуть изменения в конвейер выпуска, а затем сохранить конвейер.

Для шагов конвейера task YAML доступны следующие свойства. Дополнительные сведения см. в определении steps.task .

Условия

Задача не может определить, следует ли продолжить задание конвейера после завершения задачи, укажите только конечное состояние, например succeeded или failed. Затем последующие задачи и рабочие задания могут установить condition на основе этого статуса, чтобы определить, следует ли их запускать.

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

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

Условия, основанные на предыдущем состоянии зависимости, включают:

• Выполнено: запустите только в том случае, если все предыдущие зависимости выполнены успешно. Это поведение по умолчанию, если условие не задано в YAML. Чтобы применить это условие, укажите condition: succeeded().
• Выполнено успешно или завершилось сбоем: запуск, даже если предыдущая зависимость завершается ошибкой, если выполнение не отменено. Чтобы применить это условие, укажите condition: succeededOrFailed().
• Всегда: запуск, даже если предыдущая зависимость завершается ошибкой, даже если выполнение отменено. Чтобы применить это условие, укажите condition: always().
• Сбой. Запуск выполняется только в том случае, если предыдущая зависимость завершается ошибкой. Чтобы применить это условие, укажите condition: failed().

В следующем примере YAML PublishTestResults@2 выполняется даже в том случае, если предыдущий шаг завершился успехом или ошибкой, благодаря условию succeededOrFailed.

steps:
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.x'
    architecture: 'x64'
- task: PublishTestResults@2
  inputs:
    testResultsFiles: "**/TEST-*.xml"
  condition: succeededOrFailed()

Продолжить выполнение при ошибке

Свойство continueOnError сообщает задаче, следует ли продолжать выполнение и сообщать об успешном выполнении независимо от сбоев. Если задано значение true, это свойство сообщает задаче игнорировать failed состояние и продолжить выполнение. Подчиненные шаги и задания обрабатывают результат задачи как success при принятии решений о запуске.

Включен

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

Количество повторных попыток при сбое задачи

Свойство retryCountOnTaskFailure задает количество повторов задачи, если она завершается ошибкой. Значение по умолчанию равно нулю повторных попыток.

• Максимально допустимое число повторных попыток — 10.
• Время ожидания перед повтором увеличивается после каждой неудачной попытки, следуя экспоненциальной стратегии отката. Первая повторная попытка происходит через 1 секунду, вторую повторную попытку через 4 секунды и десятую повторную попытку после 100 секунд.
• Повторная попытка задачи не обеспечивает идемпотентность. Побочные эффекты первой попытки, такие как частичное создание внешнего ресурса, могут привести к сбою повторных попыток.
• К задаче не предоставляется информация о количестве повторных попыток.
• Сбой задачи добавляет предупреждение в журналы задач, указывающее, что она завершилась сбоем перед повтором задачи.
• Все попытки повторных попыток отображаются в пользовательском интерфейсе в составе одного узла задачи.

resources:
  containers:
  - container: pycontainer
    image: python:3.11

steps:
- task: SampleTask@1
  target: host
- task: AnotherTask@1
  target: pycontainer

Время ожидания

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

В классических конвейерах задачи предлагают несколько параметров управления.

Включен

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

Продолжить при ошибке

Выберите этот параметр, если вы хотите, чтобы эта задача сообщала об успешном выполнении, даже если она завершается ошибкой, возможно, позволяя зависимым задачам выполняться в том же задании. Общая сборка или развертывание не может быть более чем частично успешной. Зависят ли последующие задачи от настройки Запустить эту задачу, зависит от их параметра.

Количество повторов, если задача завершилась сбоем

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

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

Время ожидания

Введите максимальное время в минутах, которое задача может выполняться до автоматической отмены. Значение по умолчанию — 0, или бесконечное время. Установка значения, отличного от нуля, переопределяет настройку для задания родительской задачи. Период времени ожидания начинается при запуске задачи и не включает время, когда задача находится в очереди или ожидает агента.

Выполнение этой задачи

Выберите одно из следующих условий для выполнения этой задачи:

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

Задача конвейера YAML может указать env свойство, в котором перечислены строки имени и значения, представляющие средовые переменные.

- task: AzureCLI@2
  env:
    ENV_VARIABLE_NAME: value
    ENV_VARIABLE_NAME2: value
  ...

Переменные среды можно задать с помощью шагов script или с помощью скриптов в командной строке, задачах Bash или PowerShell.

В следующем примере выполняется шаг script, который присваивает значение переменной среды ENV_VARIABLE_NAME и выводит значение.

- script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: value
  displayName: 'echo environment variable'

Предыдущий сценарий функционально совпадает с выполнением задачи Bash@3 с входными данными script . В следующем примере используется task синтаксис.

- task: Bash@3
  inputs:
    script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: value
  displayName: 'echo environment variable'

В классических конвейерах можно добавлять и изменять переменные среды в разделе "Переменные среды " редактора задач.

Создайте файл azure-pipelines.yml , имеющий следующее содержимое в базовом каталоге проекта.

pool:
  vmImage: 'windows-latest'

jobs:
- job: NodeJS
  strategy:
    matrix:
      node14:
        nodeVersion: '14.x'
      node16:
        nodeVersion: '16.x'
    maxParallel: 2
  steps:
    - task: NodeTool@0
      displayName: 'Install Node.js $(nodeVersion)'
      inputs:
        versionSpec: '$(nodeVersion)'
        checkLatest: true

    - script: |
        echo Using Node version $(nodeVersion)
        node --version
      displayName: 'Verify Node Installation'

Сохраните и запустите конвейер. Задание выполняется дважды, по одному для каждой версии Node.js, указанной в переменной nodeVersion .

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

1. В задании агента для классического конвейера в Плане выполнения установите параллелизм на многоконфигурационный режим.

2. В разделе "Множители" введите nodeVersion.

3. Задайте максимальное число агентов2.

4. Добавьте задачу установки инструментов Node.js в ваш конвейер со следующими параметрами:

   • Введите $(nodeVersion) в поле Спецификация версии.
   • Установите флажок для проверки последней версии.

5. Добавьте задачу командной строки в конвейер и введите следующий код в разделе "Скрипт".

   echo Using Node version $(nodeVersion)
node --version

6. На вкладке "Переменные" определите переменную nodeVersion со значением 14.x, 16.x и выберите Settable во время очереди.

   Примечание.

   В конвейере релиза выберите Settable at release time. См. дополнительные сведения в статье Как изменить переменные во время релиза?

7. Нажмите Сохранить и поместить в очередь.

8. На экране "Запуск конвейера" нажмите кнопку "Сохранить и запустить".

Задание выполняется дважды, по одному для каждой версии Node.js, указанной в переменной nodeVersion . Задача установщика средствNode.js загружает версию Node.js, если она еще не включена в агент. Задача командной строки регистрирует расположение версии Node.js на диске.