Настройка конвейеров для поддержки отслеживания работы

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Для поддержки интеграции и слеживаемости в рамках Azure DevOps Services с потоками, можно настроить несколько вариантов. Вы можете сообщить о состоянии конвейера, скопировать синтаксис для индикаторов состояния и настроить автоматическое связывание рабочих элементов со сборками и выпусками.

Поддерживаемые функции интеграции с конвейером и отслеживанием работы

Некоторые функции обеспечивают поддержку сквозной трассируемости, когда пользовательские истории и функции проходят через цикл разработки. Как и в Azure Repos, рабочие элементы можно связать с объектами конвейера со следующими типами ссылок: сборка, интеграция в сборку и интеграция в выпуск. Ссылка на Интегрированная среда выпуска может быть создана только при включении опции Сообщить статус выпуска в Boards в классических конвейерах выпуска.

В следующей таблице перечислены точки интеграции между Azure Boards и Azure Pipelines. Параметры и шаги конфигурации различаются в зависимости от того, настраивается ли конвейер YAML или Классическая версия Azure DevOps. Большинство вариантов поддерживаются для конвейеров, выполняемых в репозитории Azure Repos Git, если иное не указано.

Функция

Description

Поддерживаемые версии

---

Связывайте рабочие элементы вручную со сборками

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

Все версии

---

Просмотр сборок, связанных с рабочим элементом

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

Все версии

---

Автоматическое связывание рабочих элементов со сборками

Требуется для заполнения элемента управления "Разработка" с помощью встроенных ссылок на сборку. Рабочие элементы или коммиты, которые являются частью выпуска, определяются на основе версий артефактов. Например, каждая сборка в Azure Pipelines связана с набором рабочих задач и коммитов. Дополнительные сведения см. в статье "Автоматическое связывание рабочих элементов " далее в этой статье.

YAML, Azure DevOps Server 2020 и более поздние версии

---

Автоматически связывать рабочие элементы с выпусками и сообщать о статусе развертывания для элемента работы (только классическая версия)

Требуется для заполнения контрола "Развертывание" в форме рабочего элемента ссылками «Интегрировано на стадии выпуска». Для получения дополнительной информации см. раздел Отчет о состоянии развертывания в Boards далее в этой статье.

Azure DevOps Server 2020 и более поздних версий

---

Просмотр списка рабочих элементов, связанных со сборкой или выпуском

Просмотрите и откройте элементы работы, включенные в сборку или релиз.

YAML, Azure DevOps Server 2020 и более новые версии

---

Создание рабочего элемента при сбое (классическая модель)

Автоматически создайте рабочий элемент при сбое сборки и при необходимости задайте значения для полей рабочих элементов. Дополнительные сведения см. в статье "Создание рабочего элемента при сбое " далее в этой статье.

Версии 2018 и позже

---

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

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

Azure DevOps Server 2020 и более поздних версий

---

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

• Чтобы настроить параметры интеграции для классического конвейера выпуска, необходимо иметь разрешения на изменение выпуска.
• Чтобы связать рабочие элементы с коммитами и запросами на вытягивание, необходимо иметь разрешение Изменить рабочие элементы в этом узле, установленное на Разрешено для пути области, назначенной рабочему элементу. По умолчанию у группы "Участники" задано такое разрешение.
• Чтобы просмотреть рабочие элементы, необходимо иметь Просмотр рабочих элементов в этом узле разрешен для узла области, назначенной рабочему элементу.

Открытие параметров конвейера, параметров сборки или параметров интеграции

YAML

Открытие параметров конвейера

Для конвейеров выпуска, определенных YAML, можно настроить интеграцию с помощью диалогового окна параметров конвейера .

1. Откройте конвейер, выберите "Дополнительные действия" и выберите "Параметры".

   

   Откроется диалоговое окно "Параметры конвейера". Дополнительные сведения об автоматическом связывании см. в статье "Автоматическое связывание рабочих элементов " далее в этой статье.

   

Классическая сборка

Свойства сборки

Откройте конвейер сборки, выберите изменение конвейера и перейдите на вкладку "Параметры ".

Откроется страница свойств сборки.

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

• Формат номера сборки
• Автоматическое связывание рабочих элементов
• Создание рабочего элемента при сбое
• Индикатор состояния

Классический выпуск

Опции интеграции выпуска

Для классических конвейеров выпусков откройте Конвейеры>Выпуски, выберите вариант редактирования конвейера, затем выберите Параметры и Интеграции.

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

• Сообщить состояние развертывания хосту репозитория
• Сообщить статус развертывания для Work
• Отправлять отчет о состоянии развертывания в Boards
• Передать сведения о состоянии развертывания в Jira
• Включить эмблему состояния развертывания

Автоматическое связывание рабочих элементов со сборками или выпусками

Включив автоматическую привязку, можно отслеживать сборки или выпуски, включавшие выполненную работу, без необходимости вручную просматривать большой объем сборок или выпусков. Каждая успешная сборка, связанная с рабочим элементом, автоматически отображается в элементе управления "Разработка" формы рабочего элемента. Каждый этап выпуска, связанный с рабочим элементом, автоматически отображается в элементе управления "Развертывание " формы рабочего элемента.

YAML

1. Откройте параметры конвейера, как описано в Открытии параметров конвейера.

2. Включите автоматическую привязку новых работ в этой сборке.

   

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

Классическая сборка

1. Откройте конвейер Свойства сборки, как описано в Свойства сборки.

2. Включите автоматическое связывание рабочих элементов, включенных в этот запуск. Добавьте ветви для включения или исключения.
   

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

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

   

3. Сохраните свой конвейер.

Классический выпуск

Перед выбором параметров интеграции настройте этапы выпуска, как описано в Разделе "Определение потока непрерывного развертывания (CD)".

1. Откройте Опции>Интеграции для потока выпуска, как описано в опциях интеграции выпуска.

2. Установите флажок "Состояние развертывания отчета" в Boards. Сопоставьте тип развертывания с каждым этапом или оставьте не сопоставленным. Выберите этот параметр, если нужно создать ссылки на все рабочие элементы, представляющие соответствующие изменения в источнике, после завершения выпуска. Этот параметр должен быть включен, чтобы элемент управления формой рабочего элемента развертывания функционировал.

   

   Чтобы просмотреть список рабочих элементов, связанных с выпуском, выберите "Выпуск" (старое представление) из дополнительных команд и перейдите на вкладку "Рабочие элементы".

   

3. Сохраните свой конвейер.

Проверка интеграции

Чтобы проверить работу интеграции, выполните следующие действия.

1. Свяжите один или несколько рабочих элементов с коммитом или pull-реквестом в репозитории Azure Repos Git. Дополнительные сведения см. в разделе:

   • Инициирование разработки Git из рабочего элемента
   • Ссылка на рабочие элементы из других объектов

2. Запуск конвейера.

3. Откройте один из связанных рабочих элементов и просмотрите элемент управления "Развертывание ". Как показано на следующем рисунке, элемент управления развертыванием отображает сведения о выпуске для двух этапов выпуска тех рабочих элементов, которые связаны с фиксацией Git или запросом на вытягивание для конвейера выпуска, настроенного для интеграции с Azure Boards.

Какие элементы работы включены в автоматическую привязку?

При разработке вашего программного обеспечения можно связать рабочие элементы при создании ветки, коммита или пулл-реквеста. Кроме того, вы можете инициировать ветвь, совершить фиксацию или создать запрос на вытягивание из рабочего элемента, автоматически связывая эти объекты, как описано в Управление разработкой Git из рабочего элемента. Например, здесь мы создадим новую ветвь из пользовательской истории формы отмены заказа.

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

• Для первой сборки:

  • Найдите все рабочие элементы, связанные с веткой, коммитами и пул-реквестами, связанными со сборкой.

• Для последующих сборок:

  • Определите все рабочие элементы, связанные со сборкой текущей фиксации (C1).
  • Определите все рабочие элементы, связанные с коммитом (C2) последней успешной сборки той же исходной ветви.
  • Определите все рабочие элементы, связанные с коммитами между C1 и C2 в дереве коммитов.

Создание рабочего элемента при сбое сборки (классическая модель)

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

Совет

Параметр создания рабочего элемента при сбое поддерживается только для классических конвейеров. Для этого с помощью конвейера YAML можно использовать расширение Marketplace, например создать ошибку при сбое выпуска или реализовать его с помощью Azure CLI или вызовов REST API.

1. Откройте параметры сборки конвейера, как описано в свойствах сборки.

2. Включите создание рабочего элемента при сбое и выберите тип создаваемого рабочего элемента. При необходимости установите флажок "Назначить запрашивателю", чтобы задать поле "Назначить" и добавить поля, которые необходимо установить в создаваемом рабочем элементе.

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

   

3. Сохраните свой конвейер.

Чтобы узнать имя ссылки для поля, найдите его из индекса поля рабочего элемента. Для настраиваемых полей, добавленных с помощью наследуемого процесса, компания Azure DevOps присваивает ссылочное имя на основе удобного для понимания имени поля с префиксом Custom. Например, вы добавили поле с именем DevOps Triage. Имя ссылки — Custom.DevOpsTriage. Пробелы не допускаются в имени ссылки.

Установка или включение индикатора состояния

YAML

1. Откройте конвейер "Дополнительные действия" и выберите значок состояния.

   

2. Выберите ветвь и область интересов, а затем нажмите кнопку "Копировать в буфер обмена ", чтобы скопировать изображение или синтаксис Markdown.

   

Классическая сборка

1. Откройте свойства сборки, как описано в разделе Свойства сборки.

2. Выберите "Копировать в буфер обмена ", чтобы скопировать изображение или синтаксис Markdown.

   

3. Сохраните свой конвейер.

Классический выпуск

Выберите этот параметр, если требуется отобразить последний результат развертывания этапа на внешнем веб-сайте.

1. Установите флажок "Включить значок состояния развертывания". Затем выберите этапы, для которых нужно отобразить результат. По умолчанию выбираются все этапы, определенные для выпуска.

   

2. Выберите "Копировать в буфер обмена ", чтобы скопировать изображение или синтаксис Markdown.

   

3. Сохраните свой конвейер.

Сообщите о состоянии развертывания в узле репозитория (классическая модель)

Если код хранится в репозитории Azure Repos Git, вы можете настроить конвейер выпуска для отображения значка на страницах Azure Repos. Значок указывает, где была развернута конкретная фиксация, и прошел ли или провалился данный деплоймент. Этот параметр улучшает прослеживаемость от фиксации кода до развертывания.

Состояние развертывания отображается в следующих разделах Azure Repos.

• Файлы: указывает состояние последнего развертывания для выбранной ветви.
• Фиксации: указывает состояние развертывания для каждой фиксации (требуется включить триггер непрерывной интеграции (CD) для вашего выпуска).
• Ветви: указывает состояние последнего развертывания для каждой ветви.

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

Сообщите о состоянии развертывания в Jira (классический)

Включите задачи в Jira в рабочие элементы и создайте ссылки на все задачи при завершении этапа. Установите Приложение Azure Pipelines для Jira в облаке Jira Software и добавьте организацию для создания подключения.

Чтобы обеспечить интеграцию с отслеживанием проблем Jira, установите Azure DevOps для Jira и подключите организации Azure DevOps к вашему экземпляру Jira Software. Вы можете подключить несколько организаций к одному экземпляру и получать данные для всех ваших команд и связанных проектов. Дополнительные сведения см. в статье "Подключение Azure DevOps к Jira".

Связанные статьи

• Определение многоэтапного конвейера непрерывного развертывания (CD)
• Связывание рабочих элементов с другими объектами
• Обзор конвейеров выпуска (классическая модель)
• Получение всех рабочих элементов, связанных с конвейером выпуска с помощью API Azure DevOps
• Осуществлять разработку Git из рабочего элемента
• Связывание рабочих элементов с другими объектами
• Обеспечьте сквозную трассировку
• Обратитесь к справочнику типов ссылок