Ekipler İçin Git İş Akışı Stratejileri
Özellik dallarını (feature branches), GitFlow'u ve ana dal tabanlı geliştirmeyi (trunk-based development) karşılaştırın, ardından her birinin gerçek bir ekipte çalışmasını sağlayan komutları, dal korumasını ve özellik bayraklarını görün.

İlk projelerimden birinde bir özellik dalı (feature branch) üç hafta boyunca yaşadı. Sonunda birleştirmeye çalıştığımızda, Git 40 çakışan dosya bildirdi; bunlardan ikisi main dalında başka biri tarafından yeniden yazılmıştı. Birleştirme tam bir gün sürdü ve kimse sonucu o hafta dağıtılabilecek kadar güvenilir bulmadı. Dal üzerindeki kod iyiydi. Sorun iş akışıydı, çünkü entegrasyon borcunun kimsenin göremediği bir yerde birikmesine izin vermişti.
Bir Git iş akışı seçmek, çoğunlukla işin main dalından ne kadar süre ayrı kalmasına izin verildiğiyle ilgili bir karardır. Bu yazı, en sık gördüğüm üç stratejiyi karşılaştırıyor, her birini çalıştıran komutları ve ayarları gösteriyor ve size seçim için bir kural sunuyor.
Hızlı Çıkarımlar
- Belirleyici faktör dal ömrüdür: iş
maindalından ne kadar uzun süre ayrılırsa, birleştirmenin maliyeti o kadar artar. - Çekme istekleri (pull requests) olan özellik dalları, dalların haftalar değil günler boyunca yaşadığı sürece çoğu ekibe uyar.
- GitFlow, paralel olarak desteklenmesi gereken sürümlü yayınlara sahip yazılımlara uyar; sürekli dağıtılan bir web uygulaması için gereksiz bir yüktür.
- Ana dal tabanlı geliştirme (trunk-based development), hızlı CI'nız ve bitmemiş işleri gizlemek için özellik bayraklarınız (feature flags) olduğunda işe yarar.
- Hangisini seçerseniz seçin, bir wiki sayfası yerine dal korumasıyla (branch protection) uygulayın.
Özellik dalı (feature branch) iş akışı nedir?
Herkes main dalından oluşturulan kısa dallar üzerinde çalışır ve bir çekme isteği (pull request) aracılığıyla birleştirir. Basittir, inceleme yerleşiktir ve main dalı yayınlanabilir durumda kalır. Zayıf yönü ise hiçbir şeyin bir dalın eskimesini engellememesidir.
git switch main && git pull --ff-only
git switch -c feature/invoice-export
# small commits while you work
git add -p && git commit -m "Add CSV export for invoices"
# before opening the PR, replay your work on the latest main
git fetch origin && git rebase origin/main
git push -u origin feature/invoice-export
gh pr create --fill
Çekme isteğini açmadan önce rebase yapmak, geçmişi doğrusal tutar ve değişiklik hala küçükken çakışmaları ortaya çıkarır. Yardımcı olan bir alışkanlık: eğer bir dal üç günden eskiyse, ya sahip olduğunuzu bir bayrağın arkasına birleştirin ya da bölün.
GitFlow ne zaman mantıklıdır?
GitFlow, uzun ömürlü main ve develop dallarının yanı sıra feature/*, release/* ve hotfix/* dallarını kullanır. Açık bir yayın süreci sunar ve aynı anda birden fazla yayınlanmış sürümün bakımını destekler; bu, kullanıcıların aynı gün yükseltme yapmadığı mobil uygulamalar, masaüstü yazılımları veya kütüphaneler için önemlidir.
Haftada birçok kez dağıtım yapan bir web hizmeti için, ek bir seremoni getirir: iki entegrasyon dalı, yayın dalının her ikisine de geri birleşmesi ve bir hotfix'in unutulabileceği birçok yer. Eğer CI/CD'niz main dalından dağıtım yapıyorsa, muhtemelen buna ihtiyacınız yoktur.
Ana dal tabanlı geliştirme (trunk-based development) pratikte nasıl çalışır?
Herkes en az günlük olarak main dalına entegre olur, dallar saatlerce yaşar. Bitmemiş işler kapalı olarak üretime gönderilir. Minimal bir özellik bayrağı (feature flag) şöyle görünür:
const flags = {
invoiceExport: process.env.FLAG_INVOICE_EXPORT === "true",
};
export function exportMenu(user: User) {
const items = [{ label: "Print", action: "print" }];
if (flags.invoiceExport || user.isInternal) {
items.push({ label: "Export CSV", action: "export-csv" });
}
return items;
}
Bayraklar bedava değildir. Her bayrak, kodunuzda her iki durum için de bir test ve bir kaldırma tarihi gerektiren bir daldır; eski bayraklar kendi başlarına bir teknik borçtur. Ana dal tabanlı geliştirme aynı zamanda hızlı, güvenilir CI'ya bağlıdır, böylece bozuk bir commit dakikalar içinde tespit edilir ve geri alınır. GitHub Actions ile CI/CD yazısında açıklanan pipeline ön koşuldur.
Ekibim için bir iş akışını nasıl seçerim?
| Durum | Başlangıç noktası |
|---|---|
2-5 mühendis, main dalından dağıtım | Özellik dalları veya bayraklarla ana dal tabanlı |
| 5-15 mühendis, çekme isteği incelemeleri gerekli | Dal koruması ve boyut sınırlamaları olan özellik dalları |
| Sürümlü yayınlar, aynı anda birkaç tane destekleniyor | GitFlow veya ana daldan kesilen yayın dalları |
| Büyük ekip, güçlü CI, günlük dağıtımlar | Bayraklar ve birleştirme kuyrukları ile ana dal tabanlı |
Ekip büyüklüğü, yayın sıklığı ve CI'nızın ne kadar hızlı yanıt verdiği kadar önemli değildir. Eğer tam bir pipeline 40 dakika sürüyorsa, kısa ömürlü dallar diyagram ne derse desin acı verici gelecektir.
İş akışını sadece belgelemek yerine nasıl uygularım?
Dal koruması (branch protection) kuralınızı bir kurala dönüştürür. GitHub CLI ile aynı korumayı bir JSON dosyasından her depoya uygulayabilirsiniz:
cat > protection.json <<'EOF'
{
"required_status_checks": { "strict": true, "contexts": ["test"] },
"enforce_admins": true,
"required_pull_request_reviews": { "required_approving_review_count": 1 },
"restrictions": null
}
EOF
gh api -X PUT repos/OWNER/REPO/branches/main/protection --input protection.json
Bu, main dalına herhangi bir şey ulaşmadan önce güncel bir dal, geçen bir test kontrolü ve bir onaylayıcı inceleme gerektirir. Bunu düzenli bir geçmiş için squash birleştirme ve "bu değişiklik ne yapıyor ve nasıl test edildi" diye soran bir çekme isteği şablonuyla birleştirin. İyi incelemeler kural kadar önemlidir; bkz. Hızı Düşürmeden Hataları Yakalayan Kod İnceleme Uygulamaları.
Hangi alışkanlıklar iş akışından daha önemlidir?
- Küçük, odaklanmış commit'ler. İncelemesi ve geri alması kolaydır.
- Nedenini açıklayan mesajlar. "Yeniden deneme döngüsünü düzelt" bir yıl sonra kimseye yardımcı olmaz; "Çift ücretlendirmeyi önlemek için 4xx yanıtlarını yeniden denemeyi durdur" yardımcı olur.
- Düzenli olarak push yapın. Sadece dizüstü bilgisayarınızda bulunan iş görünmezdir ve yedeklenmemiştir.
- Birleştirilmiş dalları silin. Depo ayarlarında otomatik silmeyi açın.
Sırada ne yapmalıyım?
git branch -r --sort=committerdate komutunu çalıştırın ve en eski uzak dallara bakın. Eğer herhangi biri bir haftadan eskiyse, sahibine birleşmeyi neyin engellediğini sorun. Ardından ekibinizin maksimum dal yaşını not alın, yukarıdaki JSON ile dal korumasını etkinleştirin ve bir ay sonra sonucu gözden geçirin. Monorepolar için aynı fikirler, Monorepolar için CI/CD Pipeline Desenleri yazısında ele alındığı gibi yol filtreleriyle birleşir.
Uğur Kaval
Modern teknolojilerle yenilikçi çözümler geliştirmede uzmanlaşmış AI/ML Mühendisi & Full Stack Geliştirici. Otomasyon, makine öğrenmesi ve web geliştirme tutkunu.


