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

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

  • Статья

Azure DevOps Services

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

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

Заметка

Файл YAML можно экспортировать только из существующего классического конвейера, созданного с помощью классического конструктора сборок. Если вы не видите возможность экспорта в JSON или YAML, конвейер не поддерживает экспорт. Классические конвейеры выпуска не имеют параметра экспорта в 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. Введите сообщение о фиксации, нажмите кнопку "Зафиксировать" непосредственно в главной ветви, а затем нажмите кнопку "Сохранить и снова запустить ". Новый запуск начинается и фиксируется в репозитории. Дождитесь завершения задания.

    Зафиксируйте сообщение для фиксации в главной ветви, а затем нажмите кнопку

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

  1. Войдите в свою организацию Azure DevOps и перейдите в проект.

  2. Выберите Конвейеры>Конвейеры.

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

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

  4. Откройте скачанный ФАЙЛ YAML в редакторе кода.

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

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

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

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

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

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

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

  1. Выберите многоточие (...) и нажмите кнопку "Удалить".

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

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

Существует ли задача в конвейерах YAML для создания рабочих элементов при сбое сборки?

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

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

Следующие шаги

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

Использование Azure Pipelines