Ana içeriğe geç

Sürüm Yönetimi Kılavuzu

İçindekiler

Giriş

Bu belge, GitHub kullanarak sürüm yönetimi sürecimizi açıklar. Sürüm kontrolü, sürüm oluşturma ve sürüm notlarının tutulması için kılavuz sağlar.

Sürüm Süreci

  1. Özellik Geliştirme
  2. develop dalından özellik dalları oluştur
  3. İsimlendirme formatı: feature/ozellik-adi

  4. Tamamlandığında develop'a PR gönder

  5. Sürüm Hazırlığı

  6. develop'dan sürüm dalı oluştur: 
    git checkout develop
git pull
git checkout -b release/vX.Y.Z
  7. Kararlılığı sağlamak için son testleri yap
  8. İlgili dosyalardaki sürüm numaralarını güncelle (örn. package.json, README.md)

  9. Değişiklikleri özetleyen sürüm notlarını hazırla

  10. Sürüm Dağıtımı

  11. Sürüm dalını main'e birleştir: 
    git checkout main
git merge release/vX.Y.Z
  12. Sürümü etiketle: 
    git tag -a vX.Y.Z -m "Sürüm vX.Y.Z"
git push origin vX.Y.Z
  13. Sürüm dalını develop'a geri birleştir: 
    git checkout develop
git merge release/vX.Y.Z
  14. Sürüm dalını sil: 
    git branch -d release/vX.Y.Z

Sürüm Numaralandırma

Anlamsal Sürümleme (SemVer) kullanıyoruz: - Ana Sürüm (X): Uyumsuz API değişiklikleri - Alt Sürüm (Y): Yeni özellikler (geriye dönük uyumlu) - Yama Sürümü (Z): Hata düzeltmeleri ve küçük güncellemeler

Örnek: v1.2.3

Dal Stratejisi

  • main: Üretime hazır kod
  • develop: Geliştirme dalı
  • feature/*: Yeni özellikler
  • release/*: Sürüm hazırlığı
  • hotfix/*: Acil düzeltmeler

Sürüm Oluşturma

  1. Sürüm Dalı Oluştur ```bash git checkout develop git pull git checkout -b release/vX.Y.Z

Acil Düzeltme Süreci

Genel Bakış

Acil düzeltme süreci, üretim ortamında acil müdahale gerektiren kritik sorunları çözmek için kullanılır. Bu süreç, düzeltmenin hızlı bir şekilde uygulanmasını sağlarken uygun sürüm kontrolü ve dal yönetimini korur.

Acil Düzeltme Süreci Adımları

1. Acil Düzeltme Dalı Oluştur

  • Üretim koduna dayalı olması için main dalından başla
  • Acil düzeltme için yeni bir dal oluştur: 
    git checkout main
git pull
git checkout -b hotfix/vX.Y.Z+1

2. Düzeltmeyi Uygula

  • Sorunu çözmek için gerekli değişiklikleri yap
  • Düzeltmenin sorunu çözdüğünden ve yeni sorunlar yaratmadığından emin olmak için kapsamlı test yap

3. Sürüm Numarasını Güncelle

  • İlgili dosyalarda yama sürümünü artır (örn. package.json, README.md)
  • Değişiklikleri commit'le: 
    git add .
git commit -m "Acil Düzeltme: [sorunun kısa açıklaması]"

4. Acil Düzeltmeyi main'e Birleştir

  • Düzeltmeyi üretim koduna uygulamak için acil düzeltme dalını main'e birleştir: 
    git checkout main
git merge hotfix/vX.Y.Z+1

5. Acil Düzeltme Sürümünü Etiketle

  • Acil düzeltme sürümü için yeni bir etiket oluştur: 
    git tag -a vX.Y.Z+1 -m "Acil Düzeltme vX.Y.Z+1"
git push origin vX.Y.Z+1

6. Acil Düzeltmeyi develop'a Birleştir

  • Geliştirme kod tabanını güncel tutmak için düzeltmenin develop dalına da uygulandığından emin ol: 
    git checkout develop
git pull
git merge hotfix/vX.Y.Z+1

7. Acil Düzeltme Dalını Sil

  • Acil düzeltme birleştirilip etiketlendikten sonra, depoyu temiz tutmak için dalı sil: 
    git branch -d hotfix/vX.Y.Z+1
git push origin --delete hotfix/vX.Y.Z+1

Notlar

  • Acil düzeltmeyi main'e birleştirmeden önce kapsamlı test yap
  • Sürüm numarasının tüm ilgili dosyalarda tutarlı şekilde güncellendiğinden emin ol
  • Acil düzeltme sürümünü ekip ve paydaşlara bildir

Örnek Komutlar

```bash

Adım 1: Acil düzeltme dalı oluştur

git checkout main git pull git checkout -b hotfix/v1.2.4

Adım 2: Düzeltmeyi uygula ve commit'le

(Kodda değişiklikler yap)

git add . git commit -m "Acil Düzeltme: Üretimdeki kritik sorunu düzelt"

Adım 3: Main'e birleştir

git checkout main git merge hotfix/v1.2.4

Adım 4: Sürümü etiketle

git tag -a v1.2.4 -m "Acil Düzeltme v1.2.4" git push origin v1.2.4

Adım 5: Develop'a birleştir

git checkout develop git pull git merge hotfix/v1.2.4

Adım 6: Acil düzeltme dalını sil

git branch -d hotfix/v1.2.4 git push origin --delete hotfix/v1.2.4