GitFlow Eğitimi: Özellikler, Sürümler ve Hotfix’ler için Dallanma

GitFlow Kurulumu

GitFlow’un yapılandırılmış dallanma modelinden yararlanmadan önce, onu makinenize kurmanız ve deponuzda başlatmanız gerekir. Neyse ki her iki adım da basittir.

GitFlow’u kullanmak için makinenizde Git yüklü olmalıdır. Git’i yükleme hakkında daha fazla bilgiyi Git Yükleme Eğitimi’nde okuyabilirsiniz.

GitFlow’u yükleme

GitFlow, Git’in bir uzantısıdır; bu nedenle ayrı olarak yüklemeniz gerekir. Varsayılan olarak Git ile birlikte gelmez. Kurulum süreci işletim sisteminize bağlıdır.

GitFlow’u nasıl yükleyeceğinize ilişkin daha ayrıntılı talimatlar için resmî belgeleri okuyun.

Not: Yukarıdaki GitFlow uzantısı, basit komutlarla özellik dallarını, sürümleri ve hotfix’leri yönetmeyi kolaylaştırsa da kesinlikle zorunlu değildir. GitFlow iş akışını, standart Git komutlarını kullanarak—adlandırma kuralları ve birleştirme uygulamalarında tutarlı olduğunuz sürece—izleyebilirsiniz. Araç yalnızca süreci otomatikleştirir ve uygular; bu da ekipler veya daha büyük projeler için faydalı olabilir.

macOS

macOS için en popüler paket yöneticisi olan Homebrew’u kullanıyorsanız şunu çalıştırın:

brew install git-flow-avh

Linux (Debian/Ubuntu tabanlı)

Ubuntu gibi Debian tabanlı bir sistem kullanıyorsanız şunu kullanın:

sudo apt-get install git-flow

Windows

Windows kullanıyorsanız, GitFlow’u Git for Windows üzerinden kurabilir ve terminalinize Git Bash ekleyebilirsiniz.

GitFlow’un kurulup kurulmadığını kontrol etmek için şunu çalıştırabilirsiniz:

git flow version

Bir depoda GitFlow’u başlatma

İlk adım olarak, GitFlow’u kullanmadan önce başlatılmış bir Git deponuz olmalıdır. Daha fazlasını Bir Git Deposunu Nasıl Başlatır ve Ayarlarsınız yazısında okuyabilirsiniz.

GitFlow kurulduktan sonra, mevcut herhangi bir Git deposunda şununla başlatabilirsiniz:

git flow init

GitFlow sizden birkaç ayarı yapılandırmanızı isteyecektir. İşte bunların ne anlama geldiği ve doğru seçimlerin nasıl yapılacağına dair bir özet:

1. Dal adları: Varsayılan dal adları sorulacaktır.
1. Üretim dalı adı (varsayılan: master)
2. Geliştirme dalı adı (varsayılan develop)
2. Destekleyici dallar için önekler: GitFlow farklı dal türleri için adlandırma kuralları kullanır.
1. Özellik dalları: feature/
2. Hata düzeltme dalları: bugfix/
3. Sürüm dalları: release/
4. Hotfix dalları: hotfix/
5. Destek dalları: support/ (pratikte nadiren kullanılır)
6. Sürüm etiketi öneki: v (ör. v.1.2.0)

Varsayılanlar çoğu ekip için iyi çalışır, ancak kuruluşunuzun adlandırma standartlarına uyacak şekilde özelleştirebilirsiniz.

Başlatmanın örnek çıktısı:

git flow init

Which branch should be used for bringing forth production releases?
   - master
Branch name for production releases: [master]
Branch name for "next release" development: [develop]

How to name your supporting branch prefixes?
Feature branches? [feature/]
Bugfix branches? [bugfix/]
Release branches? [release/]
Hotfix branches? [hotfix/]
Support branches? [support/]
Version tag prefix? [] v

Başlattıktan sonra, develop dalını uzak deponuza itebilirsiniz. Dalları nasıl push ve pull yapacağınıza dair daha fazlasını Git Push ve Pull Eğitimi’nde okuyabilirsiniz.

Geliştirme için GitFlow Kullanımı

GitFlow deponuzda başlatıldıktan sonra, geliştirme iş akışınızı yönetmek için dallanma modelini kullanmaya başlayabilirsiniz. GitFlow, özellikler, sürümler ve hotfix’lerle çalışmak için üst düzey komutlar sağlar; bu da yapıyı korumayı ve Git kaosundan kaçınmayı kolaylaştırır.

Bir sonraki alt bölümlerde GitFlow’u pratikte inceleyeceğiz.

Özellik dalları oluşturma

Özellik dalları, ana kod tabanını etkilemeden yeni işlevler geliştirmek için kullanılır.

Bir özellik dalı oluşturmak için şunu çalıştırabilirsiniz:

git flow feature start <feature-name>

Bu komut, develop’tan feature/<feature-name> adlı yeni bir dal oluşturur. Özelliğinizi geliştirmeye başlayabilir ve her zamanki gibi değişiklikleri commit’leyebilirsiniz.

Özellik dallarını bitirme

Özelliğiniz tamamlanıp test edildiğinde, şununla bitirebilirsiniz: 

git flow feature finish <feature-name>

Bu komut şunları yapar:

• Özellik dalınızı develop dalına birleştirir.
• Yerel feature/<feature-name> dalını siler.

Birleştirme çakışmalarıyla karşılaşırsanız, bunları elle çözün ve Git’in standart çakışma çözümleme akışını kullanarak birleştirmeyi tamamlayın.

Pull request oluşturulup önce incelenmesi gereken daha büyük ekiplerde çalışıyorsanız, GitFlow’un finish komutunu doğrudan kullanamazsınız; bunun yerine şunları yapabilirsiniz:

1. Çalışmanızı commit’leyin ve ardından dalı itin:

git push origin feature/<feature-name>

2. GitHub, GitLab vb. üzerinde feature/<feature-name>’den develop’a bir pull request oluşturun.
3. İnceleme isteyin, testleri çalıştırın ve onayları alın.
4. Onaylandıktan sonra platformun arayüzünden birleştirin ve dalı silin.

GitHub hakkında daha fazla bilgi edinmek ve nasıl kullanacağınızı öğrenmek isterseniz GitHub Foundations ve GitHub Concepts kurslarını öneririm. Diğer ekiplerde standart git flow feature finish akışını takip edebilirsiniz; ancak develop’a geri birleştirmeden önce dalınız için inceleme istemeniz ve uygun davranışı sağlamak için kod değişikliklerinizde testleri çalıştırmanız gerekir.

Sürüm dalları oluşturma

Sürüm dalları, develop dalındaki devam eden geliştirmeyi engellemeden yeni bir üretim sürümüne hazırlanmak için oluşturulur.

Bir sürüme başlamak için şunu çalıştırın:

git flow release start <version-number>

Bu, release/<version-number> adlı yeni bir dal oluşturur. Bu dal develop’tan dallanır.

Bu dalda genellikle sürüm numaralarını son hâline getirir, küçük hataları düzeltir ve dokümantasyon ile değişiklik günlüklerini güncellersiniz.

Sürüm dallarını bitirme

Sürümünüz üretime hazır olduğunda şununla bitirin:

git flow release finish <version-number>

Bu komut:

• Sürüm dalını hem master hem de develop’a birleştirir.
• master’da sürümü etiketler (ör. v1.0.0).
• Yerel release/<release-number> dalını siler.

Değişikliklerinizi ve etiketlerinizi göndermeyi unutmayın:

git push origin master
git push origin develop
git push --tags

# or in short
git push origin master develop --tags

Hotfix dalları oluşturma

Hotfix’ler, master dalında bir hata bulunduğunda yapılan acil üretim düzeltmeleri için kullanılır.

Bir hotfix’e başlamak için:

git flow hotfix start <version-number>

Bu, master’dan hotfix/<version-number> dalını oluşturur. Şimdi değişiklikleri uygulayıp düzeltmeyi commit’leyebilirsiniz.

İşiniz bittiğinde şununla tamamlayın:

git flow hotfix finish <version-number>

Bu işlem:

• Hotfix’i master ve develop’a birleştirir.
• Düzeltmeyi master üzerinde etiketler.
• Yerel `hotfix/<version-number> dalını siler.

Yerel değişikliklerinizi ve etiketlerinizi her zamanki gibi itin:

git push origin master develop --tags

Hotfix’ler özellikle güçlüdür; çünkü develop dalındaki devam eden geliştirmeye müdahale etmeden üretim sorunlarını hızla düzeltmenizi sağlar.

Düşünün ki bazı yeni özellikler develop’a zaten birleştirildi ve henüz yayımlamak istemiyorsunuz; ancak üretim uygulamasında acil ve ciddi bir hatanın düzeltilmesi gerekiyor. 

İşte hotfix’ler burada işe yarar; çünkü master’dan dallanırlar ve yalnızca develop’a geri birleştirilirler.

GitFlow Dallanma Örneği

GitFlow’u uygulamada görmek ve geleneksel Git komutlarıyla karşılaştırmak için iki yaygın iş akışını—bir özellik geliştirme döngüsünü ve hotfix içeren bir sürümü—adım adım inceleyelim.

Her iki tarafı da görerek, GitFlow uzantısının birden fazla Git adımını basit, standart komutlara sararak süreci nasıl sadeleştirdiğini daha iyi anlayacaksınız.

Geleneksel Git komutlarına hızlı bir genel bakışa ihtiyacınız varsa Complete Git Cheat Sheet’i öneririm. Git hakkında hızlı bir özet istiyorsanız Yeni Başlayanlar için GitHub ve Git Eğitimi’ni okuyun.

Özellik geliştirme iş akışı

Uygulamanıza kullanıcıların kimlik doğrulaması yapmasını sağlayan yeni bir özellik geliştirdiğinizi varsayalım. Bu özelliğe user-authentication adını veriyorsunuz.

GitFlow kullanarak:

git flow feature start user-authentication

# Work on the feature
git add .
git commit -m "feat: Implement basic user authentication"

# Once finished:
git flow feature finish user-authentication

git push origin develop

Şimdi normal Git kullanarak:

# Create and switch to a new branch manually
git checkout -b feature/user-authentication develop

# Work on the feature
git add .
git commit -m "Implement basic user authentication"

# Once finished
git checkout develop
git merge feature/user-authentication
git branch -d feature/user-authentication
git push origin develop

Gördüğünüz gibi GitFlow komut sayısını ve dolayısıyla karmaşıklık düzeyini azaltır. Yanlış dala yanlışlıkla birleştirme gibi hatalara da daha az açıktır.

Git’te birleştirmenin nasıl çalıştığını öğrenmek için Git Merge Eğitimi: Örneklerle Kapsamlı Rehber’i okuyun.

Şimdi de diyelim ki 1.0.0 sürümü için hazırlık yapıyorsunuz. Fakat yeni sürümü yayımladıktan kısa bir süre sonra, hotfix ile düzeltilmesi gereken kritik bir hata bulundu. 

GitFlow kullanarak:

# Start a release
git flow release start 1.0.0

# Make final tweaks, update version numbers
git commit -am "Prepare release v1.0.0"

# Finish the release
git flow release finish 1.0.0
git push origin master develop --tags

Şimdi hatayı buldunuz ve bir hotfix oluşturmanız gerekiyor:

# Start a hotfix
git flow hotfix start 1.0.1

# Apply the fix
git commit -am "Fix login issue in production"

# Finish the hotfix
git flow hotfix finish 1.0.1
git push origin master develop --tags

Ve tüm bunları bir de geleneksel Git komutlarıyla yaparsak:

# Release manually
git checkout -b release/1.0.0 develop

# Make changes
git commit -am "Prepare release v1.0.0"

# Merge manually
git checkout master
git merge release/1.0.0
git tag -a v1.0.0 -m "Release v1.0.0"
git checkout develop
git merge release/1.0.0

# Delete release branch
git branch -d release/1.0.0
git push origin master develop --tags

# Hotfix manually
git checkout -b hotfix/1.0.1 master

# Apply fix
git commit -am "Fix login issue in production"
git checkout master
git merge hotfix/1.0.1
git tag -a v1.0.1 -m "Hotfix v1.0.1"
git checkout develop
git merge hotfix/1.0.1

# Delete hotfix branch
git branch -d hotfix/1.0.1
git push origin master develop --tags

GitFlow Kullanımı için En İyi Uygulamalar

GitFlow oldukça güçlüdür ve ekibinizin kodunu yönetmenize yardımcı olur. Ancak bu yapıdan en iyi şekilde yararlanmak için bazı en iyi uygulamaları izlemeniz gerekir.

Bu uygulamalar, dalları temiz tutmaya, birleştirme çakışmalarını azaltmaya ve özellikle iş birliğine dayalı ortamlarda ekip verimliliğini artırmaya yardımcı olur.

Tutarlı dal adlandırma

İş birliğinde tutarlılık kilit önemdedir. Ekibinizin özelleştirmek için güçlü bir nedeni olmadıkça GitFlow’un varsayılan adlandırma kurallarına sadık kalın.

Önerilen adlandırma kalıpları:

• Özellik dalları: feature/<feature-name>
• Sürüm dalları: release/<version-number>
• Hotfix dalları: hotfix/<version-number>

Çok kelimeli adlar için kebab-case kullanmalısınız (ör. feature/user-authentication).

Küçük ve sık değişiklikler

Uzun ömürlü dallar genellikle can sıkıcı birleştirmelere ve gözden geçirilmesi zor, aşırı kapsamlı pull request’lere yol açar. 

Bunu tecrübe ederek öğrendim; defalarca birleştirme çakışması cehenneminden geçtim ve mümkünse bundan kaçınmak istersiniz!

Bunun yerine, özellik dallarını kısa ömürlü tutun ve tek bir göreve odaklanın. Çalışmanızı kaybetmemek veya develop’tan fazla uzaklaşmamak için düzenli olarak commit ve push yapın.

Daha küçük ve artımlı değişiklikler test etmeyi, gözden geçirmeyi ve tümleştirmeyi kolaylaştırır.

Develop ile düzenli senkronizasyon

Bir özellik dalında çalışırken geride kalmamanız gerekir. Daha sonra birleştirme çakışmalarını en aza indirmek için develop dalından düzenli olarak en son değişiklikleri çektiğinizden emin olun:

git checkout feature/<your-feature>
git fetch origin
git rebase origin/develop

Senkron kalmak, tümleştirmeyi daha sorunsuz hâle getirir ve değişikliklerinizin başkalarının geliştirdiği özelliklerle uyumlu olmasını sağlar.

Birleştirmeden önce inceleme ve test

GitFlow, git flow feature finish gibi komutlarla doğrudan birleştirmeyi desteklese de, develop ve master’a yapılacak tüm birleştirmeler için pull request (PR) veya merge request (MR) kullanmak en iyisidir.

Faydalar:

• Kod inceleme ve onay iş akışlarını etkinleştirir
• Otomatik CI/CD kontrollerini tetikler
• Değişikliklerin net bir iz kaydını sağlar

Bu, kalite kontrolünün önemli olduğu üretim seviyesindeki ortamlarda özellikle kritiktir.

GitFlow Sorun Giderme

GitFlow gibi yapılandırılmış bir iş akışıyla bile, özellikle ekiplerle çalışırken veya uzun soluklu dallarda sorunlar ortaya çıkabilir. 

Bu bölümde en yaygın zorlukları ve bunları etkili şekilde nasıl çözeceğinizi ele alacağız.

Birleştirme çakışmaları

Daha büyük bir ekiple aynı kod tabanı üzerinde çalışırken birleştirme çakışmaları yaygındır ve can sıkıcıdır. Genellikle iki dalın aynı kod satırlarını değiştirmesiyle ortaya çıkarlar.

Birleştirme çakışmasını çözme adımları:

1. git flow finish sürecini durdurun.
2. Dalınızı hedef dalına elle birleştirin:

git checkout develop
git merge feature/<your-feature>

3. Git sizden çakışmaları çözmenizi isteyecektir. Çakışan dosyaları açın ve aşağıdaki gibi işaretleri arayın:

<<<<<<< HEAD
Code from develop
=======
Code from feature branch
>>>>>>> feature/my-feature

4. Kodu elle düzenleyin ve temizleyin.
5. Çözdükten sonra dosyaları çözüldü olarak işaretleyin:

git add <resolved-file>

6. Ardından birleştirmeyi şununla tamamlayın:

git commit -m “resolve merge conflict …”

Eski dalları temizleme

Bazen deponuzda güncelliğini yitirmiş feature, release veya hotfix dalları bulunur. Karışıklığı önlemek için deponuzu olabildiğince temiz tutun.

Aşağıdaki adımları izleyerek bunu düzeltebilirsiniz:

1. Tüm yerel dalları listeleyin:

git branch

2. Bir yerel dalı silin:

git branch -d <branch-name>

3. Dal henüz birleştirilmediyse ve silinebileceğinden eminseniz:

git branch -D <branch-name>

4. Uzak bir dalı silin:

git push origin --delete <branch-name>

Deponuzu olabildiğince temiz tutmak için dallarınızı düzenli olarak kontrol etmek ve eski dalları temizlemek önemlidir.

Sonuç

GitFlow, geliştirme iş akışınızda iş birliği, açıklık ve kontrol için sağlam bir çerçevedir. Daha çok kişinin yer aldığı bir solo projede çalışıyor olun ya da büyük bir ekibe katkı sağlıyor olun, GitFlow; özellik geliştirme, sürümler ve hotfix’leri net şekilde ayırarak düzenli kalmanıza yardımcı olur.

GitFlow’u ilk kullandığımda gerçekten oyunun kurallarını değiştiren bir deneyimdi. Artık birleştirme kaosu yok. Hangi dalın kullanılacağı konusunda tahmin yürütmek yok. Her işin bir yeri, her sürümün tekrarlanabilir ve güvenilir bir süreci vardı. Zamanla çalıştığım her ekibe GitFlow’u tanıttım. Her seferinde daha fazla yapı, daha sorunsuz iş birliği ve daha az hata getirdi.

Bu eğitimde şunları öğrendiniz:

• GitFlow nedir ve neden faydalıdır
• GitFlow nasıl kurulur ve başlatılır
• Özellikler, sürümler ve hotfix’lerle nasıl çalışılır
• Yaygın sorunlardan kaçınmak için en iyi uygulamalar
• Pull request’leri kullanarak GitFlow’u modern iş akışlarına nasıl uyarlayacağınız

Git iş akışınızı bir üst seviyeye taşımaya hazırsanız, bir sonraki projenizde GitFlow’u deneyin. Ve temellere hâkimseniz, onu ekibinizin CI/CD hattına, inceleme sürecine ya da GitHub Actions’a entegre etmeyi düşünmeye başlayın.