Перенос классического конвейера в YAML

Azure DevOps Services

Начните работу с Azure Pipelines, преобразовав существующий классический конвейер для использования YAML. С помощью конвейера на основе YAML вы можете реализовать стратегию CI/CD в виде кода и просмотреть ее журнал, сравнить версии, blame, добавить заметки и т. д.

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

Предварительные требования

Перед началом работы убедитесь, что у вас есть следующие элементы.

  • Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно.
  • Активная организация Azure DevOps. Регистрация в Azure Pipelines
  • Рабочий конвейер, использующий редактор классического пользовательского интерфейса.
  • Пример файла конвейера YAML в коде. Создайте пример конвейера YAML в следующем разделе.

Создание примера конвейера YAML

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

  1. Войдите в свою организацию (https://dev.azure.com/{yourorganization}) и выберите проект.

  2. Выберите Конвейеры, а затем Новый конвейер.

    Две кнопки для выбора для создания нового конвейера.

  3. Выберите расположение исходного кода: GitHub или Azure Repos Git.

    Список возможных вариантов выбора исходного кода.

  4. Выберите репозиторий.

    Страница, на которой вы выбираете репозиторий для конвейера исходного кода.

  5. На экране Настройка конвейера выберите Начальный конвейер.

    Список шаблонов для настройки нового конвейера.

  6. Выберите Сохранить и запустить.

    Страница проверки, на которой вы выбираете Сохранить и запустить.

  7. Введите сообщение о фиксации, выберите Зафиксировать непосредственно в ветвь main, а затем нажмите кнопку Сохранить и запустить еще раз. Запускается новый запуск, который фиксируется в репозитории. Дождитесь, пока он завершится.

    Сообщение фиксации для фиксации в ветвь main, а затем нажмите кнопку Сохранить и запустить.

Экспорт классического конвейера

Выполните следующие действия, чтобы экспортировать классический конвейер в ФАЙЛ YAML, который можно использовать в редакторе.

  1. Откройте классический конвейер.

  2. Щелкните многоточие (...), а затем выберите Экспорт в YAML.

    Снимок экрана: контекстное меню для экспорта конвейера в YAML.

  3. Откройте скачанный YAML-файл в редакторе кода.

  4. Если конвейер YAML содержит переменные, определенные в классическом пользовательском интерфейсе, снова определите переменные в пользовательском интерфейсе параметров конвейера или в файле YAML. Дополнительные сведения см. в разделе Определение переменных.

  5. Просмотрите все cron расписания в файле YAML. По умолчанию cron расписания в YAML имеют формат UTC. В классических конвейерах они находятся в часовом поясе организации. Дополнительные сведения см. в разделе Настройка расписаний для конвейеров.

  6. Используйте помощник по задачам, чтобы внести другие изменения в файл YAML. Помощник по задачам — это область в правой части экрана, которая помогает правильно создавать и изменять шаги YAML.

    Настройте задачу конвейера с помощью помощника по задачам.

  7. Сохраните и запустите конвейер.

Очистка ресурсов

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

  1. Щелкните многоточие (...) и нажмите кнопку Удалить.

  2. Введите имя конвейера, чтобы окончательно удалить его, а затем нажмите кнопку Удалить.

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

Есть ли в конвейерах YAML задача по созданию рабочих элементов при сбое сборки?

Конвейеры YAML не имеют параметра Создать рабочий элемент при сбое , например классические конвейеры сборки. У вас есть несколько вариантов создания этой функции самостоятельно.

  • Вы можете использовать скрипт или задачу PowerShell и вызвать REST API.
  • Вы можете использовать Azure CLI для вызова команды az boards work-item create в конвейере. См. пример использования интерфейса командной строки для создания ошибки при сбое.

Дальнейшие действия

Узнайте о различиях функций между конвейерами YAML и классическими конвейерами.