Интеграция с GitLab
Интеграция с GitLab позволяет связать процесс разработки с задачами в Timetta. Она отображает ветки, коммиты и запросы на слияние, относящиеся к конкретным задачам, и поддерживает эти данные в актуальном состоянии.
Два механизма обновления
-
Периодическая синхронизация — в типовой конфигурации раз в 15 минут запускается фоновая задача, которая обновляет данные для активных записей GitLab репозиториев в Timetta.
-
Вебхуки — если в GitLab настроен вебхук для вашего абонента в Timetta, то после Push в репозиторий и событий по Merge Request GitLab отправляет запрос в Timetta. Это ускоряет обновление данных.
Обрабатываемые события
На данный момент в Timetta обрабатываются только события Push Hook и Merge Request Hook. Остальные типы событий GitLab отклоняются.
Как Timetta сопоставляет данные из GitLab с задачей
В имени ветки должен быть код задачи в ожидаемом виде: латинские буквы, дефис, цифры, например DEV-123, PROJ-42 (регистр букв не важен).
Примеры имён веток:
feature/DEV-123/add-report;fix/dev-456/fix-filter.
Несколько кодов в имени ветки
Если в имени ветки встречается несколько кодов, для привязки к задаче берётся последний по порядку слева направо.
Пример: ветка feature/EPIC-10-TASK-42-api привяжется к задаче с кодом TASK-42, а не EPIC-10, потому что TASK-42 в имени идёт правее.
Если в ветке участвуют и эпик, и задача, заранее договоритесь, какой код должен быть последним в имени, чтобы данные подтягивались в нужную вам карточку задачи.
Как настроить
-
Включить интеграцию и задать необходимые параметры. Подробнее — Системные настройки > Интеграция с GitLab. Сохраните сгенерированный секрет, он понадобится на шаге 3.
-
Создать репозиторий в Timetta. Подробнее — GitLab Репозитории.
-
Создать вебхук в GitLab:
- в GitLab откройте Settings нужного проекта → раздел Webhooks;
- в поле URL укажите полный адрес вида
https://api.timetta.com/api/gitlab/webhooks/<домен_абонента>, где<домен_абонента>— домен вашего абонента в Timetta; - в поле Secret token вставьте секрет, который был сгенерирован на шаге 1;
- включите чек-боксы Push events и Merge request events.
Где и что видим в итоге
В Карточке задачи появляется секция Разработка. В ней отображаются ветки, коммиты и запросы на слияние, относящиеся к этой задаче.
Так же можно увидеть подробную информацию о коммитах и запросах на слияние по клику на соответствующие ссылки в секции Разработка.
Если интеграция выключена, секция Разработка не будет показана.