Git-процесс

Previous Next

AIOps использует Trunk-Based Development с короткоживущими feature branches и строгими правилами коммитов.

Основные принципы

  1. Main branch — всегда готов к деплою в production
  2. Feature branches — короткоживущие (1-3 дня max)
  3. Conventional Commits — единственный формат коммитов
  4. Pre-commit hooks — автоматическая проверка перед коммитом

Именование веток

Формат

1
<type>/<TICKET-ID>__<short_description>

Типы веток

  • feat/ — новая функциональность
  • fix/ — исправление бага
  • refactor/ — рефакторинг без изменения поведения
  • chore/ — обслуживание, зависимости
  • docs/ — только документация
  • test/ — добавление/исправление тестов

Примеры

1
2
3
4
5
feat/IDENTITY-42__add_user_creation
fix/CREDENTIAL-15__password_validation_bug
refactor/AUTH-28__extract_domain_service
chore/DEPS-03__update_sqlalchemy
docs/DOC-11__update_architecture_diagrams

Формат коммитов (Conventional Commits)

Структура

1
<type>(scope): <message>

Важно: Коммиты должны быть однострочными (без body, без footers).

Типы коммитов

  • feat — новая функциональность
  • fix — исправление бага
  • refactor — рефакторинг кода
  • perf — улучшение производительности
  • test — добавление/исправление тестов
  • docs — изменения в документации
  • style — форматирование, пробелы (не влияет на логику)
  • build — изменения в build system или зависимостях
  • ci — изменения в CI/CD конфигурации
  • chore — обслуживание, не затрагивающее src или test
  • revert — откат предыдущего коммита

Примеры

1
2
3
4
5
6
7
feat(identity): add user creation use case
fix(uow): handle transaction rollback on error
refactor(credential): extract password domain service
test(identity): add unit tests for UserDomainService
docs(architecture): update C4 container diagram
chore(deps): bump sqlalchemy to 2.0.35
ci(gitlab): add matrix testing for Python 3.11-3.13

Workflow

1. Создать feature branch

1
2
3
git checkout main
git pull origin main
git checkout -b feat/IDENTITY-42__add_user_creation

2. Работать с изменениями

1
2
3
4
5
6
# Делать изменения
git add .
git commit -m "feat(identity): add user creation use case"

# Push в remote
git push -u origin feat/IDENTITY-42__add_user_creation

3. Создать Merge Request

  • Используй шаблон MR
  • Укажи описание изменений
  • Добавь reviewer'ов
  • Убедись, что CI проходит

4. Code Review

  • Ответь на комментарии
  • Внеси исправления
  • Получи approval

5. Merge

  • Squash & Merge — предпочтительный способ
  • Удали feature branch после merge

Pre-commit Hooks

Pre-commit hooks запускаются автоматически перед каждым коммитом.

Установка

1
2
pip install pre-commit
pre-commit install

Что проверяется

  1. Базовые проверки:
  2. check-ast — валидность Python синтаксиса
  3. trailing-whitespace — пробелы в конце строк
  4. end-of-file-fixer — пустая строка в конце файла
  5. check-yaml — валидность YAML

  6. check-merge-conflict — маркеры merge конфликтов

  7. Conventional Commits:

  8. conventional-pre-commit — проверка формата сообщения коммита

  9. Python Quality:

  10. ruff check — линтинг кода
  11. ruff format — форматирование
  12. mypy — проверка типов (strict mode)

Пропуск hooks (осторожно!)

1
2
# ТОЛЬКО В КРАЙНЕМ СЛУЧАЕ
git commit --no-verify -m "..."

Никогда не пропускайте hooks без веской причины!

Правила работы с main

Запрещено:

  • ❌ Прямой push в main без Merge Request
  • ❌ Force push в main
  • ❌ Merge без approval
  • ❌ Merge с failing CI
  • ❌ Коммиты без conventional format

Обязательно:

  • ✅ Все изменения через Merge Request
  • ✅ Минимум 1 approval для merge
  • ✅ Все CI проверки должны пройти
  • ✅ Conventional Commits формат
  • ✅ Актуальная ветка с main перед merge

Rebase vs Merge

Rebase (рекомендуется)

Используй rebase для синхронизации с main:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
git checkout feat/IDENTITY-42__add_user_creation
git fetch origin
git rebase origin/main

# Если конфликты
git status
# Разрешить конфликты
git add .
git rebase --continue

git push --force-with-lease origin feat/IDENTITY-42__add_user_creation

Merge (только для main)

Merge используется только при слиянии feature branch в main через MR.

Amend Commits

НИКОГДА не используй git commit --amend для коммитов, которые уже были pushed в remote, если это не твоя личная ветка и никто другой её не использует.

1
2
3
4
5
6
7
8
9
# OK — локальный uncommitted коммит
git add .
git commit -m "feat(identity): add use case"
git commit --amend -m "feat(identity): add user creation use case"
git push

# ОПАСНО — уже pushed коммит
git push
git commit --amend  # ❌ Не делай так!

Cherry-pick

Используй cherry-pick для переноса конкретных коммитов:

1
2
git checkout target-branch
git cherry-pick <commit-hash>

Конфликты

Разрешение конфликтов

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
# 1. Получить последние изменения
git fetch origin

# 2. Rebase на main
git rebase origin/main

# 3. Разрешить конфликты вручную
# Редактировать файлы, убрать маркеры <<<<<<<, =======, >>>>>>>

# 4. Добавить разрешенные файлы
git add <файлы>

# 5. Продолжить rebase
git rebase --continue

# 6. Force push (с защитой)
git push --force-with-lease

Отменить rebase

1
git rebase --abort

Полезные команды

Просмотр истории

1
2
3
4
5
6
7
8
# Короткий лог
git log --oneline --graph --decorate --all

# Изменения в файле
git log -p <file>

# Кто изменил строку
git blame <file>

Stash (временное сохранение)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# Сохранить незакоммиченные изменения
git stash

# Посмотреть stash
git stash list

# Применить последний stash
git stash pop

# Применить конкретный stash
git stash apply stash@{1}

Откат изменений

1
2
3
4
5
6
7
8
# Откатить файл к состоянию из HEAD
git checkout HEAD -- <file>

# Откатить все незакоммиченные изменения
git reset --hard HEAD

# Откатить последний коммит (локально)
git reset --soft HEAD~1

Связанные страницы

Стандарты кода Стратегия ветвления