Интеграция GitHub с Битрикс24 (переход из Jira): выгрузка коммитов в комментарии к задачам Битрикс24

1. Интеграция GitHub как связующее звено разработки и менеджмента

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

Однако, по ряду обстоятельств решено было переехать в Битрикс24.

Боль заказчика здесь в том, что интеграция с GitHub позволяла напрямую переключаться с этой платформы на задачи в Jira.

Также можно было выгружать в комментарии к задачам ссылки на нужные коммиты.

Вот только в Битрискс24 такого функционала не оказалось, что и побудило заказчика обратиться в нашу компанию.

Для начала разберем само понятие "коммита". Если вы имели дело с разработкой, то знаете, что в этом деле не обойтись без системы контроля версий - Git.

Соответственно, GitHub - один из лучших для этого сервисов.

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

Отсюда следует, что коммит - это задокументированное изменение файлов в проекте.

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

С созданной системой коммитов сотрудникам и командам гораздо легче отслеживать изменения в проекте.

Важно отметить, что GitHub - инструмент для создания программного обеспечения.

Сервис не предназначен для управления проектом и отслеживания истории изменений, что приводит к затруднениям в оценке текущего состояния проекта на определенный момент времени.

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

Кроме того, постановка задач и управление проектом происходит в Битрикс24, и отсутствие связи между GitHub и CRM может привести к путанице у разработчика относительно коммитов.

Больше информации о миграции из Jira в Битрикс24 читайте в этом кейсе.

Как работает интеграция:

Менеджер создает задачу в системе Битрикс24.

Разработчик открывает задачу в CRM и начинает работу над ней, создавая ветку в репозитории с ID задачи в названии.

Такой подход помогает Пинкиту определить, куда отправить коммиты.

При каждом новом коммите в GitHub он автоматически связывается с соответствующим комментарием в задаче.

2. Пошаговая настройка интеграции GitHub и Битрикс24

Для настройки интеграции между Битрикс24 и GitHub выполняем следующие шаги:

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

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

На третьем шаге добавляем комментарий к задаче в Битрикс24.

Важно помнить, что исходное условие предполагает создание задачи в Битрикс24 перед созданием ветки для коммитов.

Следовательно, на этом этапе не нужно заново создавать задачу, а только обновить ее.

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

Этот функционал аналогичен интеграции GitHub и Jira.

Вариант записи коммита в пользовательское поле задачи также рассматривался.

Но из-за большого количества коммитов необходимость постоянного обновления поля могла бы сделать историю изменений неполной, поэтому этот вариант был признан неэффективным.

Интеграция не только облегчит взаимодействие как менеджера с командой, так и внутри команды разработчиков, но и уменьшит ручной труд на переключение между платформами и поиск нужного коммита.

Если вам интересно, добавить и протестировать интеграцию можно тут.

Алексей Окара,
основатель Пинол и продакт-менеджер Пинкит