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

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

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

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

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

Условия

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

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

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

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

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

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

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. В задании агента для классического конвейера в разделе "План выполнения" задайте значение Parallelism для нескольких конфигураций.

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 на диске.