Интеграция с репозиториями

В Трекере можно настроить интеграцию с репозиториями исходного кода на платформах GitHub, GitLab и Bitbucket. Это позволяет автоматически отображать в задачах Трекера связи с коммитами в репозитории.

Чтобы можно было связать коммиты с задачами в Трекере:

1. Настройте синхронизацию коммитов между репозиторием и Трекером.

   В зависимости от типа репозитория, вы можете выбрать один из способов синхронизации данных:

   Настроить вебхук в репозитории

   Настроить периодический опрос репозитория

   Репозиторий будет отправлять в Трекер информацию о коммитах. Этот способ позволяет быстро синхронизировать данные и отображать новые коммиты в задачах в Трекер.

   Как настроить вебхук в репозитории

   Трекер будет периодически запрашивать информацию о коммитах в репозитории.

   Этот способ синхронизации можно настроить для репозиториев, размещенных на онлайн-платформах или развернутых на собственном сервере.

   • Как настроить опрос репозитория Bitbucket
   • Как настроить опрос репозитория GitHub
   • Как настроить опрос репозитория GitLab

   Синхронизация коммитов с помощью вебхука, настроенного в репозитории, доступна только для репозиториев GitHub и GitLab, размещенных на собственных серверах вашей компании.

   При опросе репозитория связи с коммитами могут отображаться в Трекере с задержкой до 10 часов.

2. Включите отображение коммитов в настройках очереди. Это нужно сделать в каждой очереди, в которой нужно отображать в задачах связи с коммитами.

   Как включить коммиты в очереди

3. Чтобы привязать к задаче коммит в репозитории, укажите ключ задачи в комментарии к коммиту. Например: Исправление ошибки TEST-123.

   Привязанные коммиты можно просмотреть:

   • на странице задачи на вкладке Коммиты;
   • на странице коммитов очереди. Чтобы перейти на страницу коммитов со страницы очереди, в правом верхнем углу нажмите → Коммиты.

Как настроить в репозитории вебхук для синхронизации коммитов

Для интеграции c Трекером нужно настроить в вашем репозитории вебхук, который будет отправлять данные о новых коммитах в Трекер. Чтобы настроить вебхук, сначала сформируйте в Трекере URL и токен для вебхука.

1. В Трекере на панели слева нажмите →  Администрирование, затем откройте раздел  Репозитории.

2. Нажмите кнопку Добавить и выберите Вебхук.

3. В поле Платформа выберите GitHub или GitLab.

4. В поле Адрес сервера введите домен, на котором находится ваш репозиторий, без протокола и полного пути. Затем нажмите Добавить.

5. Дождитесь, пока в окне не появятся URL и токен для вебхука. Скопируйте и сохраните эти значения, они потребуются для настройки репозитория.

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

6. Настрой вебхук в вашем репозитории:

   • Как настроить вебхук в GitHub
   • Как настроить вебхук в GitLab

Как включить отображение коммитов в очереди

Чтобы иметь возможность просмотреть привязанные коммиты, активируйте опцию в настройках очереди:

1. На панели слева нажмите  Очереди и выберите очередь.

2. На странице очереди в правом верхнем углу нажмите  Настройки очереди.

3. Перейдите на вкладку Интеграции.

4. В разделе Коммиты активируйте опцию.