Azure Pipelines task reference

Задача выполняет действие в конвейере. Например, задача может создать приложение, взаимодействовать с ресурсами Azure, установить инструмент или провести тест. Задачи — это стандартные блоки для определения автоматизации в конвейере.

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

Дополнительные сведения об общих атрибутах, поддерживаемых задачами, см. в справочнике по YAML steps.task.

Для инструкций и обучающих материалов по созданию пайплайнов с использованием задач, включая создание пользовательских задач, расширений и поиск задач на Visual Studio Marketplace, см. Tasks concepts и документация Azure Pipelines .

Открытый исходный код

Эти задачи открытый код on GitHub. Отзывы и вклады приветствуются. Список изменений задач см. в журнала изменений задач конвейера, включая историческую запись обновлений задач.

Вопросы и ответы

Что такое псевдонимы входных данных задачи?

Входные данные для задачи определяются label, nameи могут включать один или несколько необязательных aliases. В следующем примере представлен фрагмент исходного кода для ввода известных узлов входных данных задачи InstallSSHKey@0.

{
    "name": "hostName",
    "aliases": [
        "knownHostsEntry"
    ],
    "label": "Known Hosts Entry"
    ...
}

До появления конвейеров YAML в 2019 году конвейеры были созданы и изменены с помощью редактора конвейеров на основе пользовательского интерфейса, а для ссылки на входные данные задачи используются только label.

Когда в 2019 году появились конвейеры YAML, авторы конвейеров начали использовать входные данные задачи name для ссылки на входные данные задачи. В некоторых случаях имена входных данных задачи не были описательными, поэтому aliases были добавлены для предоставления дополнительных описательных имен для входных данных задач.

Например, задача имеет входные данные известных узлов с именем , который ожидает запись из файла known_hosts. Метка известных узлов в классическом конструкторе конвейеров делает это ясно, но не так ясно при использовании имени hostName в конвейере YAML. Введены псевдонимы входных данных задач, позволяющие авторам задач предоставлять декриптивные имена для своих ранее созданных задач, а для задачи InstallSSHKey@0 добавлен псевдоним knownHostsEntry, а также добавлен, сохраняя исходное hostName имя для совместимости с существующими конвейерами с помощью этого имени.

Все элементы в aliases входных данных задачи взаимозаменяемы с name в конвейере YAML. Следующие два фрагмента YAML функционально идентичны, в первом примере используется псевдоним knownHostsEntry и второй пример с помощью hostName.

- task: InstallSSHKey@0
  inputs:
    # Using knownHostsEntry alias
    knownHostsEntry: 'sample known hosts entry line'
    # Remainder of task inputs omitted

- task: InstallSSHKey@0
  inputs:
    # Using hostName name
    hostName: 'sample known hosts entry line'
    # Remainder of task inputs omitted

Начиная с Azure DevOps Server версии 2019.1, был представлен редактор конвейера YAML, который обеспечивает функциональность типа intellisense.

Редактор конвейера YAML использует Yamlschema — получение REST API для получения схемы, используемой для проверки в редакторе. Если входные данные задачи имеют псевдоним, схема добавляет псевдоним к основному имени YAML для входных данных задачи, а псевдоним предлагается intellisense.

В следующем примере приведены входные данные задачи для задачи схемы YAML с в позиции имени и в коллекции .

"properties": {
    "knownHostsEntry": {
      "type": "string",
      "description": "Known Hosts Entry",
      "ignoreCase": "key",
      "aliases": [
        "hostName"
      ]
    },

Так как intellisense в редакторе конвейера YAML отображает , а YAML, созданный помощником по задачам , использует в созданном YAML, ссылка на задачу отображает из исходного кода задачи в качестве имени YAML для ввода задачи. Если задача имеет несколько псевдонимов (есть несколько с двумя псевдонимами), первый псевдоним используется в качестве имени.

Почему ссылка на задачу изменилась?

Справочная документация задач Azure Pipelines была перенесена на текущее место для поддержки следующих улучшений.

• Статьи о задачах генерируются с использованием исходного кода задач из Azure Pipelines задач открытый код репозитории.
• Имена входных и псевдонимов задач создаются из источника задач, поэтому они всегда актуальны.
• Блоки синтаксиса YAML создаются из источника задач, поэтому они актуальны.
• Поддерживает вклад сообщества с интегрированным содержимым пользователя, например расширенными описаниями входных задач, примечаниями и примерами.
• Обеспечивает покрытие задач для всех поддерживаемых версий Azure DevOps.
• Обновляет каждый спринт, чтобы покрыть последние обновления.

Дополнительные сведения см. в статье Участие всодержимого задач.

Где можно узнать пошаговые инструкции по созданию приложения?

Сборка приложения

Можно ли добавить собственные задачи сборки?

Да: Добавление задачи сборки

Что такое задачи установщика?

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

Предыдущие версии

• Azure DevOps Server справочник задачи 2020.1
• Azure DevOps Server справочник задачи 2020 года
• Azure DevOps Server справочник задачи 2019.1
• Azure DevOps Server справочник задачи 2019 года
• Справочник задачи TFS 2018