Bisect

Продвинутый Git

Amanda Crawford-Adamo

Software and Data Engineer

Что такое git bisect?

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

Команда Git Bisect

git bisect

Назначение

Быстрый поиск проблемного коммита
Незаменим при отладке данных
Ускоряет поиск первопричины

Bisect — запуск

Запустите сеанс git bisect
```
git bisect start
```
Отметьте текущее состояние как плохое
```
git bisect bad
```
Укажите последнее известное хорошее состояние
```
git bisect good <commit-hash>
```

График коммитов: первые два коммита отмечены зелёным как хорошие, последний — красным как известный плохой. Между ними три коммита серого цвета — их статус неизвестен. Последний хороший коммит помечен командой git bisect good, плохой — git bisect bad.

Bisect — поиск

Помечает текущий коммит как плохой
```
git bisect bad
```
Помечает текущий коммит как хороший
```
git bisect good
```

График коммитов: первые два отмечены зелёным как хорошие, последний — красным как известный плохой. Между ними три серых коммита с неизвестным статусом. Git bisect использует бинарный поиск, начиная с среднего коммита, затем переходит к левому или правому.

Bisect — автоматический поиск

Проверяет коммит на наличие ошибок, запуская автоматический тестовый скрипт.

git bisect run <script_name>

Скрипт должен возвращать 0, если тесты пройдены.
При неудаче — ненулевое значение.

Bisect — результат

Пример вывода Git Bisect

$ git log
b1a534f is the first bad commit
commit b1a534f89l2c3d4e5f6g7h8i9j0k1l2m3n4o5p
Author: Jane Doe <[email protected]>
Date:   Thu Mar 14 14:30:00 2024 -0500

Update data transformation logic

Завершает процесс бисекции и возвращает к текущему HEAD

git bisect reset

Когда использовать git bisect

Сценарии применения

Поиск регрессий в конвейерах данных
Использование тестовых скриптов для ускорения отладки

Советы

Автоматизируйте тестирование с помощью git bisect run <test-script>
Используйте информативные сообщения коммитов

Давайте потренируемся!

Продвинутый Git