Интеграция с GitLab

Описание интеграции

Интеграция Пачка×GitLab позволяет получать события из вашего Gitlab прямо в чаты Пачки.

Выглядит это следующим образом: в Пачке создается бот, который забирает информацию из выбранного проекта GitLab. Затем вы можете добавить этого бота в любой чат, куда он будет отправлять вам сообщения о событиях из этого проекта.

Можно создавать и добавлять в чаты любое количество ботов.

События, отображаемые ботом

1. Push Hook - пуши в различные ветки / запросы на слияние

Бот присылает в чат сообщение с информацией:

• в какую ветку пуш
• в какой проект пуш
• кто сделал пуш
• количество коммитов
• по коммитам: id коммита, ссылка на коммит, название коммита, автор коммита

2. Pipeline Hook - ci / cd (деплой, успешно / не успешно)

Бот присылает в чат сообщение с информацией:

• успешная сборка или нет
• в какой ветке
• в каком проекте
• кто запускал
• название pipeline
• если ошибка, то на каком этапе

3. Note Hook - комментарии (запросов, обсуждений, коммитов…)

Бот присылает в чат сообщение с информацией:

• тип сущности, к которой поставили комментарий (запрос, обсуждение, коммит)
• название сущности
• название проекта
• автор комментария
• текст комментария

4. Issue events - задачи (создание / закрытие)

Бот присылает в чат сообщение с информацией:

• название задачи
• статус задачи
• автора задачи

Кто может создавать интеграции с GitLab

Интеграцию может создать любой сотрудник. Он может сделать ее приватной или разрешить пользоваться ей своим коллегам. Делается это с помощью настроек, о них расскажем ниже.

Добавить и удалить интеграцию из чата может только администратор или создатель чата. Поэтому если хотите создать интеграцию для себя, то создайте новый чат и добавьте ее туда.

Как настроить интеграцию Пачка×GitLab

1. Создайте новую интеграцию GitLab:

1.1 Откройте раздел «Автоматизации» в левом боковом меню

1.2 Выберите подраздел «Интеграции»

1.3 В витрине интеграций найдите GitLab и нажмите на карточку

1.4 Нажмите «+», чтобы добавить новую интеграцию

‍2. Настройте интеграцию в Пачке

2.1 Придумайте название боту. Это как имя пользователя - по нему будет легко добавить бота в чат и идентифицировать его, когда он будет присылать сообщения

2.2 Скопируйте Webhook URL из Пачки

2.3. Выберите, где будет использоваться бот: для одного чата или для нескольких.

2.4. Выберите тех, кто сможет настраивать бота. Они увидят его в своем разделе интеграций и смогут менять настройки.

2.5. Выберите тех, кто сможет добавлять вашего бота в чаты. Эти пользователи смогут добавлять бота в чаты и получать от него сообщения.

3. Настройте интеграцию в GitLab

3.1 Войдите в свою панель инструментов GitLab и перейдите к Project > Settings > Webhooks

3.2 Вставьте URL-адрес, который вы скопировали на этапе настройки интеграции в Пачке.

3.3 Проверьте флажки, соответствующие событиям GitLab, которые вы хотите отправлять в Пачку в качестве уведомлений

4. Добавьте созданную интеграцию в чат

4.1 Зайдите в настройки чата (серая иконка в правом верхнем углу чата)

4.2 Выберете «Интеграции»

4.3 Добавите созданную интеграцию