Git reflog

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

Amanda Crawford-Adamo

Software and Data Engineer

Что такое Git Reflog?

Локальная запись ВСЕХ обновлений ссылок в репозитории
Reflog хранится на локальной машине в директории .git/logs/refs/heads/
Фиксирует изменения верхушек веток и положения HEAD
Служит защитным механизмом для операций Git
Помогает восстановить случайно изменённые или удалённые данные

Пример графа изменений истории git

Git Reflog и Git Log: сравнение

Параметр	Git Reflog	Git Log
Назначение	Показывает обновления ссылок и перезаписи в локальном репозитории	Показывает только историю коммитов
Область	Только локальный репозиторий	Локальный и удалённые репозитории
Содержимое	Все обновления ссылок (коммиты, сбросы, слияния и т. д.)	Только коммиты
Хранение	Временно (обычно 90 дней)	Постоянно (часть истории репозитория)
Применение	Восстановление потерянных коммитов, анализ последних действий	Просмотр истории проекта, анализ разработки функций

Команды Reflog

Отображает данные лога и активность HEAD
```
git reflog
git reflog show
```

Удаляет устаревшие или недостижимые записи лога
```
git reflog expire
```

Структура вывода Reflog

Разбор структуры вывода reflog

Пример вывода reflog в терминале

Компонент	Описание
short-hash	Сокращённый хеш коммита
ref	Обычно HEAD, но может быть именем ветки
index	Позиция в reflog (0 — самая последняя)
action	Тип действия (commit, reset, merge и т. д.)
descriptions	Описание действия

¹ https://hackernoon.com/time-to-rewrite-your-git-history-effectively-with-git-reflog

Фильтрация: since и until

since = показать записи начиная с этого момента
```
git reflog --since "time-qualifer"
```
until = показать записи до этого момента
```
git reflog --until "time-qualifer"
```

Использование

git reflog --since="1 week ago"
git reflog --until="yesterday"
git reflog --until="2024-01-01"

Восстановление удалённых веток

Сценарий

Создана ветка etl-feature
В эту ветку закоммичены изменения ETL-функции
Ветка была случайно удалена
Все изменения кода потеряны

Как восстановить ветку etl-feature?

Решение

Найдите хеш коммита на верхушке удалённой ветки с помощью git reflog
Выполните git checkout, чтобы переместить HEAD на хеш этого коммита
Создайте новую ветку из коммита, на который указывает HEAD

git reflog
git checkout <hash>
git checkout -b <branch-name>

¹ https://stackoverflow.com/questions/3640764/can-i-recover-a-branch-after-its-deletion-in-git

Git Reset

Перемещает HEAD на указанный объект коммита.
В зависимости от типа сброса обновляются рабочая директория и индекс.

Тип сброса	Команда	Рабочая директория	Индекс (staging)
Soft	`git reset --soft <commit>`	Без изменений	Изменения остаются в индексе
Mixed (по умолчанию)	`git reset --mixed <commit>`	Без изменений	Изменения убраны из индекса
Hard	`git reset --hard <commit>`	Изменения удалены	Изменения удалены

Поиск утерянного коммита

Сценарий

После коммитов и rebase тесты начали падать
Причина сбоя неизвестна
Нужно вернуться к рабочему состоянию

Как откатиться к предыдущей версии ETL-скрипта?

Решение

Найдите хеш утерянного коммита с помощью Git Reflog
Выполните git reset, чтобы откатиться к коммиту с прошедшими тестами

git reflog
git reset --soft HEAD@{1}

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

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

Git reflog

Что такое Git Reflog?

Git Reflog и Git Log: сравнение

Команды Reflog

Структура вывода Reflog

Фильтрация: since и until

Использование

Восстановление удалённых веток

Сценарий

Решение

Git Reset

Поиск утерянного коммита

Сценарий

Решение

Рекомендации

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