====== UCH's Git-Flow ======

Projelerimde git'in gücünü bu iş akışı ile ortaya çıkarıyorum.

Amerikayı yeniden keşfetmeye gerek yok, Vincent Driessen'ın [[https://nvie.com/posts/a-successful-git-branching-model/|A successful Git branching model]] mimarisini saf Git komutlarıyla git-flow eklentisi yüklemeden kullanıyorum.

===== Sıfırdan Repo Kurulumu ======

<code bash>
# 1. Repoyu başlat
git init
# 2. Main dalının oluşabilmesi için ilk (boş) commit'i at.
git commit --allow-empty -m "<ORNEK_COMMIT_MESAJI>"
# 3. Develop dalını oluştur ve o dala geç.
git checkout -b develop
# 4. Uzak sunucuyu (GitHub, GitLab vb.) bağla.
git remote add origin <UZAK_SUNUCU_URL>
# 5. Her iki dalı da uzak sunucuya gönder.
git push -u origin main
git push -u origin develop
</code>

===== Dallar =====

==== Ana Dallar ====

Bu iki dal projenin kalbidir ve asla silinmezler. Üzerlerinde doğrudan düzenleme yapılmaz.

^ main | her zaman canlıdaki en stabil kodu temsil eder. |
^ develop | Bir sonraki sürüm için hazırlanan en güncel geliştirme kodlarını içerir. Tüm yeni özellikler günün sonunda buraya merge edilir. |

==== Özellik Dalları  ====

Yeni bir özellik veya eklenti geliştirirken kullanılır.

<WRAP round important>
''develop'''den dallanır, günün sonunda ''develop'' dalına birleşir.
</WRAP>

<WRAP round important>
İsimlendirme Kuralı: ''feature-<OZELLIK-ADI>''
</WRAP>

=== Komutlar ===

Yeni özellik dalı oluşturma ve geçiş yapma;

<code bash>
git checkout -b feature-<OZELLIK-ADI> develop
</code>

Özelliğin geliştirmesi bittikten sonra, develop dalına birleştirmek için;

<code bash>
git checkout develop
git merge --no-ff feature-<OZELLIK-ADI>
</code>

<WRAP round important>
''--no-ff'' bayrağı dalın geçmişini korur ve commit'leri tek bir düğümde toplar. Çok önemlidir!)
</WRAP>

Dalı silme ve güncel develop'u sunucuya göndermek için;

<code bash>
git branch -d feature-<OZELLIK-ADI>
git push origin develop
</code>

==== Sürüm Dalları ====

Yeni bir canlı sürüm (production release) hazırlığı için kullanılır. Yeni özellik eklenmez, sadece ufak hatalar giderilir (bugfix) ve versiyon (v1.2.0 vb.) numaraları güncellenir.

<WRAP round important>
''develop'''den dallanır, günün sonunda ''main'' ve ''develop'' dalına birleşir.
</WRAP>

<WRAP round important>
İsimlendirme Kuralı: ''release-*''  (Örn: ''release-1.2.0'')
</WRAP>

=== Komutlar ===

== Sürüm dalı oluşturma ==

<code bash>
git checkout -b release-<SEMANTIK-SÜRÜM-NUMARASI> develop
</code>

> Projelerimde Semantik sürüm numaralandırma sistemini kullanıyorum, detay için; [[https://semver.org/lang/tr/]]

Kalan ufak hataları kapatıp verisyon numarasını güncelledikten sonra ((Genelde projelerimde çeşitli scriptlerle semantik sürümü otomatik olarak arttırıyorum.)) sürümü bitirip main'a birleştirme ve etiketlemek için;

<code bash>
git checkout main
git merge --no-ff release-<SEMANTIK-SÜRÜM-NUMARASI>
git tag -a <SEMANTIK-SÜRÜM-NUMARASI> -m "Sürüm <SEMANTIK-SÜRÜM-NUMARASI> yayında"
</code>


Yapılan ufak hata düzeltmelerini develop'a da yansıtmak için;

<code bash>
git checkout develop
git merge --no-ff release-<SEMANTIK-SÜRÜM-NUMARASI> develop
</code>

Dalı silip ve tüm değişiklikleri (etiket ile birlikte) uzak sunucuya göndermek için;

<code bash>
git branch -d release-<SEMANTIK-SÜRÜM-NUMARASI>
git push origin main
git push origin develop
git push --tags
</code>

==== Acil Yama Dalları (Hotfix Branches) ====

Canlı ortamdaki (production) kritik bir hatayı çok acil çözmek gerektiğinde kullanılır. Sıradaki büyük sürümü bekleyemeyeceğiniz durumlar içindir.

<WRAP round important>
''main'''den dallanır, günün sonunda ''main'' ve ''develop'' dalına birleşir.
</WRAP>

<WRAP round important>
İsimlendirme Kuralı: ''hotfix-*''  (Örn: ''hotfix-1.2.1'')
</WRAP>


=== Komutlar ===

Acil yama dalı oluşturmak için;

<code bash>
git checkout -b hotfix-<SEMANTIK-SÜRÜM-NUMARASI> main
</code>

Kritik hatayı düzeltip, versiyonu güncelledikten sonra commitleyip yamayı bitirip main'e birleştirmek için;

<code bash>
git checkout main
git merge --no-ff hotfix-<SEMANTIK-SÜRÜM-NUMARASI>
git tag -a <SEMANTIK-SÜRÜM-NUMARASI> -m "<ORNEK_COMMIT_MESAJI>"
</code>

Gelecek sürümlerde aynı hatanın tekrar etmemesi adına yamatı develop'a yansıtmak için;

<code bash>
git checkout develop
git merge --no-ff hotfix-<SEMANTIK-SÜRÜM-NUMARASI>
</code>

Dalı silip ve tüm değişiklikleri (etiket ile birlikte) uzak sunucuya göndermek için;

<code bash>
git branch -d hotfix-<SEMANTIK-SÜRÜM-NUMARASI>
git push origin main
git push origin develop
git push --tags
</code>


<wrap onlyprint>[[tr:cs:git:flow|UCH Viki]]'den alınmıştır.</wrap>
<wrap hide>
https://wiki.ulascemh.com/doku.php?id=tr:cs:git:flow
</wrap>