Visual Studio’da Git Push İşlemi Nasıl Yapılır? Adım Adım Rehber

Kodlamanın bir ekip işi haline geldiği günümüzde, versiyon kontrol sistemleri yazılım geliştiricilerin vazgeçilmez araçlarından biri haline geldi. Git ise bu sistemler arasında en yaygın olarak kullanılanlardan. Git’i sadece komut satırıyla değil, aynı zamanda Visual Studio gibi IDE’lerle entegre şekilde kullanmak da mümkün.

Bu yazıda, Visual Studio üzerinden Git ile push işlemi nasıl yapılır, adım adım ve anlaşılır bir şekilde anlatacağım. Push işlemi öncesindeki hazırlıklardan, branch yönetimine ve stash kullanımına kadar birçok önemli noktaya değineceğiz.

Git Push Nedir? Ne İşe Yarar?

Git push, yerel (local) bilgisayarınızda yaptığınız değişiklikleri uzak sunucuya (remote repository — örneğin GitHub) göndermek için kullanılan bir işlemdir. Push ile birlikte:

• Değişiklikleriniz yedeklenmiş olur.
• Takım arkadaşlarınız sizin yaptığınız güncellemeleri görebilir.
• Projeyi merkezi bir yapıda güncel tutabilirsiniz.

Push işlemi genellikle bir pull (güncelleme alma) işleminden sonra yapılır. Çünkü uzak sunucuda sizden önce bir başkası değişiklik yapmış olabilir. Bu değişiklikleri almadan push yapmanız, çatışmalara (conflicts) neden olabilir.

Visual Studio’da Push Öncesi Yapılması Gerekenler

Visual Studio üzerinden Git kullanırken doğrudan push yapmadan önce dikkat edilmesi gereken bazı önemli adımlar bulunur. Bunlara birlikte bakalım.

1. Ana Branch’te (main) Pull İşlemi Yapmak

Koda başlamadan önce, mutlaka main branch’indeyken bir pull işlemi gerçekleştirmeliyiz.

Neden? Çünkü sizden önce başkası main branch’te değişiklik yapmış olabilir. Bunları almadan kod yazmak çatışmalara sebep olabilir.

Yapılışı:

• Git Changes penceresinden veya Git menüsünden “Pull” seçeneğini tıklayın.

2. Yeni Bir Branch Oluşturmak

Main branch’i güncelledikten sonra kendi çalışmalarınızı yapacağınız yeni bir branch oluşturmalısınız.

📌 Bu pencerede:

• Branch name: Yeni branch’in ismini belirliyorsunuz.
• Based on: Hangi branch’e bağlı olarak oluşturulacağını seçiyorsunuz. Burada “main” seçili, yani bu branch, main branch’inin bir kopyası gibi başlar.
• Checkout branch (işaretli): Yeni oluşturulan branch’e otomatik olarak geçiş yapılmasını sağlar.

🔹 Son adımda “Create” butonuna tıklayarak yeni branch’inizi oluşturabilirsiniz.

Örnek: feature/homepage-fix, bug/navbar-issue gibi anlamlı isimler kullanın.

Adımlar:

• Git Repository penceresinden + New Branch seçin.
• Yeni branch’e isim verin.
• Ana branch olarak main seçili olduğundan emin olun.

3. Kod Değişiklikleri ve Stash Kullanımı

Yeni branch üzerinde çalışırken bir noktada main’e dönmeniz gerekebilir. Ancak üzerinizde değişiklik varsa doğrudan geçemezsiniz. İşte bu noktada stash devreye giriyor.

Stash, üzerinde çalıştığınız ama henüz commit etmediğiniz değişiklikleri geçici olarak kenara koymanızı sağlar.

Yapılışı:

• Yeni branch’teyken main branch’ine geçmek isterseniz bir uyarı gelir.
• Bu uyarı penceresinde “Stash the changes” seçeneğini işaretleyin.
• Böylece yaptığınız değişiklikler kaybolmadan bir kenara (Stashes bölümüne) alınmış olur.
• Main branch’e geçiş sağlanır.

📌 Not: Stash edilen değişiklikler Git Repository penceresinin sol altında, Stashes sekmesinde listelenir.

4. Main Branch’te Güncelleme Kontrolü

Main’e geçtikten sonra ekranın sağ alt köşesinde şu şekilde bir bilgi görünecektir:

• 0/0: Main branch’te herhangi bir değişiklik yapılmamış.
• 1/0: Main’de yeni bir değişiklik yapılmış. Bu durumda tekrar Pull yapmalısınız.

5. Branch’leri Birleştirmek (Merge)

Main branch’ten en güncel hali aldıktan sonra, tekrar kendi branch’imize dönüyoruz ve değişiklikleri merge ediyoruz.

Merge işlemi, bir branch’teki değişiklikleri diğerine entegre eder.

Adımlar:

• Yeni açtığınız branch’e dönün.
• Main branch’e sağ tıklayın.
• “Merge into Current Branch” seçeneğine tıklayın.

Bu sayede main’deki güncel kodlar sizin branch’inize aktarılmış olur.

6. Stash’i Geri Yüklemek

Branch’inizdeki çalışmanıza kaldığınız yerden devam etmek için, daha önce stash ettiğiniz değişiklikleri geri yüklemeniz gerekiyor.

Yapılışı:

• Git Repository penceresinde Stashes kısmına gelin.
• Stash’inize sağ tıklayın.
• Apply => “Apply All as Unstaged” seçeneğini tıklayın.

Artık tüm değişiklikleriniz geri gelmiş olacak ve commit/push işlemine hazır hale gelecektir.

Son Adım: Commit ve Push

Tüm güncellemeleri yaptıktan ve kodunuzu test ettikten sonra artık commit ve push işlemini gerçekleştirebilirsiniz.

Commit:

• Git Changes penceresinde açıklayıcı bir mesaj yazın.
• “Commit All” butonuna tıklayın.

Push:

• Ardından “Push” butonuna tıklayarak değişikliklerinizi uzak sunucuya gönderin.

Bonus: “1 Required Check Failed” Hatası Aldığınızda Ne Yapmalısınız?

Bazen push işlemi sonrası GitHub/GitLab gibi sistemlerde “1 required check failed” hatası alabilirsiniz. Bu genellikle, CI/CD pipeline’ında başarısız bir test çalışması ya da kodunuzun güncel development branch ile uyumsuz olması gibi nedenlerle oluşur.

Bu durumda yapılacak işlem adımları şunlardır:

1. Development Branch’ini Pull Edin

Öncelikle güncel development branch’ine geçiş yapın ve son halini çekin:

• Git menüsünden development branch’ine geçin.
• Ardından Pull işlemi yaparak en güncel halini alın.

2. Sorunlu Branch’e Geri Dönün

Sonrasında, hatayı aldığınız kendi feature branch’inize geri dönün.

3. Development’ı Branch’inize Merge Edin

Bu aşamada development branch’ini kendi branch’inize merge ederek uyumsuzlukları giderin.

Yapılışı:

• Git Repository penceresinden development branch’ine sağ tıklayın.
• “Merge into Current Branch” seçeneğini seçin.

4. Merge Sonrası Push

Merge işleminden sonra kendi branch’inizdeki kodu tekrar push edin.

• “Git Changes” penceresinde varsa conflict’leri çözün.
• Ardından Commit ve Push işlemlerini gerçekleştirin.

Bu işlemler sonunda “required check” hatası ortadan kalkacak ve pull request’iniz merge edilmeye hazır hale gelecektir.

Visual Studio ile Git kullanmak, doğru şekilde uygulandığında oldukça kolay ve güçlü bir süreçtir. Fakat yanlış yapıldığında bu süreç gitten “There are merge conflicts” böyle bir hata alınabilir. Push işlemi öncesinde yapılan Pull, yeni branch oluşturma, stash kullanımı ve merge işlemleri kod kalitenizi artırır ve takım içi iletişimi güçlendirir.

Bu adımları takip ederek, Git ile kodlarınızı sorunsuz bir şekilde yönetebilir ve versiyon kontrol sürecini profesyonelce yürütebilirsiniz.