GitLab

Настроить связь

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

Дополнительно можно включить автоматическое создание комментариев в задаче с информацией о мерж-реквестах. Автоматическое комментирование доступно только для Managed Service for GitLab.

Создайте хук для интеграции

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

1. Если у вас еще нет OAuth-токена для работы с Tracker API, получите его.

2. Проверьте наличие доступа к API с помощью запроса информации о текущем пользователе.

3. Откройте инстанс GitLab и перейдите к настройкам хука:

   • Для включения интеграции на весь инстанс GitLab (требуются права администратора GitLab):
     1. В панели слева нажмите на раскрывающийся список Your work и выберите пункт Admin Area.
     2. Перейдите в раздел System Hooks.
   • Для включения интеграции на отдельный проект:
     1. Перейдите в необходимый проект.
     2. В панели слева нажмите кнопку Settings и выберите пункт Webhooks.

4. Укажите параметры хука:

   • URL:

     https://api.tracker.yandex.net/v2/system/gitlab/receive?comments=true&x_org_id=<идентификатор_организации>
     

     Где:

     • comments=true — включает автоматическое создание комментариев в задаче со ссылкой и информацией о мерж-реквестах. Отключите, если комментирование не нужно. Параметр доступен только для Managed Service for GitLab.

     • <идентификатор_организации>

       Чтобы узнать идентификатор организации, перейдите на страницу Администрирование → Организации и скопируйте значение поля идентификатор.

   • Secret token — OAuth-токен робота, от имени которого будут добавляться связи, в формате OAuth <содержимое_токена>.
     Например: OAuth y1_AQAD-qJScAAAEKEQbBNnChvfBIqR_yEQl_HMO0********.

   • В разделе Trigger выключите все опции, кроме Merge request events.

   • В разделе SSL verification включите опцию Enable SSL verification.

5. Нажмите кнопку Add system hook (Add webhook для отдельного проекта).

На странице появится раздел System Hooks (Project Hooks для отдельного проекта), в котором отобразится созданный хук и его параметры.

Протестируйте хук

1. В разделе System Hooks (Project Hooks для отдельного проекта) нажмите кнопку Test.
2. В раскрывающемся списке выберите пункт Merge request events.

Тестовый запрос должен вернуть ответ Hook executed successfully: HTTP 204. Если тестовый запрос возвращает ошибку, значит параметры хука указаны неверно.

Узнайте больше

• Практическое руководство по интеграции GitLab с Yandex Tracker.

Подключить репозиторий

Чтобы подключить репозиторий на GitLab к Tracker:

1. Убедитесь, что вы авторизованы в Tracker как администратор.

2. На панели слева нажмите →  Администрирование. Затем откройте раздел  Репозитории и нажмите  Подключить.

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

4. Получите на GitLab OAuth-токен для своего репозитория. Подробную инструкцию о том, как получить токен, читайте в документации GitLab. Для корректной работы Tracker при настройке разрешения включите опции read_repository и read_api.

5. Укажите адрес репозитория в формате https://gitlab.com/<логин_владельца_репозитория>/<имя_репозитория> и токен для подключения.

6. Нажмите кнопку Подключить.

7. Убедитесь, что статус репозитория отображается в Tracker как Подключен.

Чтобы привязать коммит к задаче, укажите ключ задачи в комментарии к коммиту.

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

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

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

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

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

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

Собственный сервер

Чтобы подключить к Tracker собственный сервер:

1. Убедитесь, что вы авторизованы в Tracker как администратор.

2. На панели слева нажмите →  Администрирование. Затем откройте раздел  Репозитории и нажмите  Подключить.

3. В поле Платформа выберите сервис, к которому подключен ваш сервер.

4. В поле Ссылка на репозиторий укажите адрес репозитория на вашем сервере. Подключение к серверу должно осуществляться по технологии OAuth 2.0.

5. Получите OAuth-токен для своего репозитория.

6. В поле Токен укажите OAuth-токен для подключения к вашему серверу.

7. Нажмите кнопку Подключить.

8. Убедитесь, что статус репозиториев отображается в Tracker как Подключен.

Подробную инструкцию о том, как получить OAuth-токен, читайте в документации GitLab. Для корректной работы Tracker при настройке разрешения включите опции read_repository и read_api.