Что такое GitFlow?

GitFlow - модель управления ветками в Git

GitFlow - это стратегия организации работы с git ветками, разработанная Винсентом Дридсеном в 2010 году. Это одна из самых популярных моделей для управления версиями и развертыванием в team разработке.

Основная идея GitFlow

GitFlow определяет строгую структуру веток для:

• Разработки (development branch)
• Выпуска релизов (release branch)
• Production (main branch)
• Hotfixes (critical fixes в production)

Ветки в GitFlow

1. main (или master) - Production branch

# Всегда готов к production
# Каждый коммит - это releasable версия
# Защищена от прямых коммитов

# Тёги для версий
git tag -a v1.0.0 -m "Release version 1.0.0"

2. develop - Development branch

# Интеграция feature веток
# Всегда содержит latest changes
# Базовая ветка для feature branches

# Из develop создаются:
# - feature branches (новые фичи)
# - release branches (подготовка к release)

3. feature/ - Feature branches*

# Разветвляются ОТ develop
# Разработка новой функциональности
# Одна фича = одна ветка

# Пример веток
git checkout -b feature/user-authentication develop
git checkout -b feature/payment-integration develop
git checkout -b feature/dashboard-redesign develop

# После завершения - pull request в develop
# После merge - удаляется
git branch -d feature/user-authentication

4. release/ - Release branches*

# Разветвляются ОТ develop
# Подготовка к production release
# Bump версии, финальное тестирование, bugfixes

# Пример
git checkout -b release/1.0.0 develop

# В release ветке:
# - Update version numbers (package.json, setup.py, etc.)
# - Финальные баги
# - Тестирование

# После готовности:
# 1. Merge в main с тегом версии
# 2. Merge обратно в develop
git checkout main
git merge --no-ff release/1.0.0
git tag -a v1.0.0

git checkout develop
git merge --no-ff release/1.0.0

git branch -d release/1.0.0

5. hotfix/ - Hotfix branches*

# Разветвляются ОТ main (production!)
# Срочное исправление критичного бага в production

# Пример
git checkout -b hotfix/1.0.1 main

# После исправления
# 1. Merge в main с новым тегом
# 2. Merge в develop
git checkout main
git merge --no-ff hotfix/1.0.1
git tag -a v1.0.1

git checkout develop
git merge --no-ff hotfix/1.0.1

git branch -d hotfix/1.0.1

Полный жизненный цикл GitFlow

main           ────────────[v1.0.0]─────────────[v1.0.1]──────────[v1.1.0]
                           ↑                      ↑                ↑
                       release merge          hotfix merge     release merge
                           ↓                      ↓                ↓
develop        ─────────────●─────────────────────●───────────────●──────
              ↓            ↑              ↓       ↑          ↓     ↑
          feature/auth    |          feature/api |      feature/new |  release
              ●────────────┘              ●───────┘          ●────┘


Процесс:
1. Developer создаёт feature ветку из develop
2. Работает в feature ветке
3. Создаёт pull request в develop
4. Code review + merge в develop
5. Когда пора выпускать - создаётся release ветка из develop
6. На release ветке - финальные изменения (версия, баги)
7. Merge в main (production) с тегом версии
8. Merge обратно в develop
9. Если критичный баг в production - hotfix из main
10. Hotfix merge в main и develop

Практический пример

Сценарий: добавление новой функции (authentication)

# 1. Developer клонирует репозиторий
git clone https://github.com/company/project.git
cd project

# 2. Убедиться что на develop
git checkout develop
git pull origin develop

# 3. Создать feature ветку
git checkout -b feature/user-authentication

# 4. Работать и коммитить
echo "Authentication module" > auth.py
git add auth.py
git commit -m "feat: add user authentication module"

echo "Login handler" > handlers.py
git add handlers.py
git commit -m "feat: add login handler"

# 5. Push feature ветку
git push -u origin feature/user-authentication

# 6. Создать pull request в GitHub/GitLab
# Review + approvals

# 7. Merge в develop (через UI или CLI)
git checkout develop
git pull origin develop
git merge --no-ff feature/user-authentication
git push origin develop

# 8. Удалить feature ветку
git branch -d feature/user-authentication
git push origin --delete feature/user-authentication

Сценарий: подготовка release

# 1. Когда develop готов к release (все фичи в)
git checkout -b release/1.2.0 develop

# 2. Обновить версию
# Отредактировать package.json
{
  "version": "1.2.0",
  ...
}

git add package.json
git commit -m "chore: bump version to 1.2.0"

# 3. Финальные баги (если нужны)
git commit -m "fix: critical bug in payment handler"

# 4. Merge в main
git checkout main
git pull origin main
git merge --no-ff release/1.2.0
git tag -a v1.2.0 -m "Release 1.2.0"
git push origin main --tags

# 5. Merge обратно в develop
git checkout develop
git pull origin develop
git merge --no-ff release/1.2.0
git push origin develop

# 6. Удалить release ветку
git branch -d release/1.2.0
git push origin --delete release/1.2.0

Сценарий: критичный баг в production

# 1. Срочное исправление из main
git checkout -b hotfix/1.2.1 main

# 2. Исправить баг
echo "Fixed critical bug" > bugfix.py
git add bugfix.py
git commit -m "fix: critical security vulnerability"

# 3. Merge в main
git checkout main
git merge --no-ff hotfix/1.2.1
git tag -a v1.2.1 -m "Hotfix 1.2.1"
git push origin main --tags

# 4. Merge в develop
git checkout develop
git merge --no-ff hotfix/1.2.1
git push origin develop

# 5. Удалить hotfix ветку
git branch -d hotfix/1.2.1

Правила в GitFlow

1. Protection Rules (GitHub/GitLab)

# main branch
- Требует pull request review перед merge
- Минимум 2 approvals
- CI pipeline должен пройти
- Dismiss stale reviews при новых коммитах
- Require code owners review (CODEOWNERS файл)

# develop branch
- Требует pull request review
- Минимум 1 approval
- CI pipeline должен пройти

2. Naming Conventions

feature/JIRA-123-user-auth        # feature/JIRA_CODE-description
feature/auth-module               # или feature/description

release/1.2.0                    # release/x.y.z (semver)
release/2.0-beta                 # release/version-stage

hotfix/1.2.1                     # hotfix/x.y.z (semver)

bugfix/fix-login-error           # bugfix для develop
chore/update-dependencies        # maintenance

3. Commit Message Conventions

feat: add user authentication
fix: resolve login timeout issue
refactor: optimize database queries
chore: update dependencies
docs: update README
test: add unit tests for auth

Плюсы GitFlow

✅ Структурированность

• Ясная организация веток
• Понятный flow для team

✅ Production stability

• main всегда production-ready
• develop для промежуточной интеграции

✅ Release management

• Контролируемый выпуск версий
• Возможность параллельных разработок и release

✅ Hotfix support

• Срочные исправления не блокируют разработку

✅ Team collaboration

• Pull request workflow
• Code review process

Минусы GitFlow

❌ Сложность

• Много веток может быть confusing
• Требует discipline от team

❌ Медленнее чем trunk-based

• Больше merges = больше конфликтов
• Slower time-to-production

❌ Не подходит для CD/CI

• CD требует более частых deployments
• GitFlow лучше для scheduled releases

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

Идеален для:

• Scheduled releases (раз в месяц, квартал)
• Big team projects
• Enterprise где нужен формальный process
• Projects с maintenance версий
• Mobile apps (iOS, Android)

Не подходит для:

• Continuous Deployment (daily/hourly releases)
• Small teams
• Startups с быстрым iteration
• Микросервисы где каждый может deploy независимо

Альтернативы

1. GitHub Flow (проще)

main + feature ветки
Меньше веток, быстрее

2. GitLab Flow (гибридный)

main + develop + environment branches
Баланс между GitFlow и GitHub Flow

3. Trunk-based Development (для CI/CD)

Одна main ветка
Фиче flags для control
С развёрнут часто (daily)

Инструменты для GitFlow

git-flow extension (облегчает работу)

# Install
brew install git-flow

# Initialize
git flow init

# Feature
git flow feature start user-auth
git flow feature publish user-auth
git flow feature finish user-auth

# Release
git flow release start 1.2.0
git flow release publish 1.2.0
git flow release finish 1.2.0

# Hotfix
git flow hotfix start 1.2.1
git flow hotfix finish 1.2.1

Выводы

GitFlow = структурированный процесс управления версиями

Высоко рекомендуется для:

• Professional teams
• Enterprise projects
• Projects с планируемыми releases
• Когда нужна стабильность

Правило: выбирай GitFlow если team достаточно зрелый для дисциплинированного процесса.