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&<тип_организации>=<идентификатор_организации>.

     Где:

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

     • <тип_организации> — может принимать следующие значения:

       • x_cloud_org_id — если тип вашей организации Yandex Cloud Organization.
       • x_org_id — если тип вашей организации или Яндекс 360 для бизнеса, или одновременно Яндекс 360 для бизнеса и Yandex Cloud Organization.

     • <идентификатор_организации> — идентификатор организации на странице организаций Tracker.

   • 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. В поле Ссылка на репозиторий укажите адрес вашего сервера до любого доступного по токену репозитория.

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

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

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

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