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

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 и более поздних версий
Классический, TFS 2017.2 и более поздних версий

---

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

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

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

---

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

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

YAML, Azure DevOps Server 2020 и более поздних версий
Классический, TFS 2017.2 и более поздних версий

---

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

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

TFS 2018 и более поздних версий

---

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

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

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

---

Необходимые компоненты

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

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

YAML

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

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

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

   

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

   

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

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

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

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

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

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

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

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

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

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

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

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

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

YAML

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

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

   

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

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

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

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

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

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

   

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

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

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

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

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

   

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

   

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

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

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

1. Связывание одного или нескольких рабочих элементов с запросом фиксации или извлечения в репозитории Azure Repos Git. Подробная информация доступна в следующих статьях:

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

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

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

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

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

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

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

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

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

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

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

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

Совет

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

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

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

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

   

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

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

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

YAML

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

   

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

   

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

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

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

   

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

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

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

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

   

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

   

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

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

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

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

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

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

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

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

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

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

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