Интеграция с Яндекс Трекером
Интеграция с Яндекс Трекером позволяет настроить автоматическую отправку комментария к задаче, если она упоминается в коммите или запросе на слияния. Кроме того, интеграция позволяет автоматически изменять статус упомянутой задачи.
Создание интеграции с Яндекс Трекером
Для создания интеграции необходимо перейти в настройки проекта в раздел Интеграции и нажать кнопку Создать возле интеграции с Яндекс Трекером.
Установка соединения
- URL-адрес веб-страницы - URL, по которому доступен Яндекс Трекер. По умолчанию имеет значение
https://api.tracker.yandex.net/
- Oauth отладочный токен Яндекс Трекер - Временный токен доступа, создаваемый в интерфейсе разработчика.
- X-Cloud-Org-ID организации - Уникальный идентификатор организации (облака) в Яндекс Облаке.
Для проверки установленного соединения есть соответствующая кнопка
Триггеры
В данном разделе выбираются события - коммит или запрос на слияние, после которых срабатывает интеграция. Для работы интеграции можно упоминать задачу как в виде полной ссылки (например, https://tracker.yandex.ru/GIT-1
), так и в виде только префикса (например, GIT-1
). Упоминать задачи в запросе на слияния можно в заголовке или описании. Кроме того, интеграция будет реагировать на изменение статуса запроса на слияние.
Настройка действий - создание комментария или изменение статуса задачи, происходит также здесь.
-
Включить комментарии. Интеграция автоматически создаст комментарий в задаче с описанием события, в котором данная задача была упомянута. Для выбора полноты комментария присутствуют опции Стандартные комментарии и Расширенные комментарии.
-
Переводить задачи Яндекс Трекера в их финальное состояние. Интеграция автоматически переведет статус задачи в финальный после выполнения запроса на слияние, в котором упоминается задача. Для изменения статуса необходимо в описании запроса добавить "Закрывает <задача>". Вместо <задача> необходимо указать номер задачи, подходящий под регулярное выражение, указанное в поле Префикс для проблем в Яндекс Трекере. Для изменения статуса нескольких задач необходимо добавить указанную строку для каждой задачи отдельно. Настройка ID финального состояния позволит указать конкретный ID статуса.
-
Резолюция для закрытия задачи Яндекс Трекер. Позволяет указать резолюцию для закрытия задачи.
Сопоставление задач в Яндекс Трекере
Для ограничения списка задач, упоминание которых вызовет срабатывание интеграции, необходимо воспользоваться следующими настройками:
-
Регулярное выражение для задач в Яндекс Трекере. Сопоставление ключей задач Яндекс Трекера с регулярными выражениями, соответствующие синтаксису RE2
-
Префикс для проблем в Яндекс Трекере. Обязательное поле, в котором необходимо указать префикс задач Яндекс Трекера, упоминание которых в коммитах или запросах на слияние, будет вызывать срабатывание интеграции (например,
GIT#
).
Ограничение на число интеграций
Максимальное количество интеграций для каждого проекта 1