Git Kancalarını Anlama

Git Kancaları'na hoş geldiniz! Git kancaları, işleme oluşturma, gönderme veya gönderilmiş işlemeleri alma gibi olaylardan önce ya da sonra Git'in otomatik olarak çalıştırdığı güçlü ve özelleştirilebilir betiklerdir.

Bunları Git iş akışınızdaki otomatik denetim noktaları veya eylemler olarak düşünebilirsiniz. Proje standartlarını uygulamanıza, görevleri otomatikleştirmenize ve diğer sistemlerle bütünleşmenize yardımcı olurlar.

Her Git deposuyla birlikte bir .git/hooks dizini gelir. İçinde, genellikle .sample ile biten örnek kanca betiklerini bulursunuz.

Bir kancayı etkinleştirmek için .sample uzantısını kaldırmanız ve dosyayı çalıştırılabilir yapmanız yeterlidir. Git daha sonra kancayı uygun zamanda çalıştırır.

• Konum: .git/hooks/
• Dosyalar: Kabuk betikleri (Bash, Python, Ruby vb.)
• Etkinleştirme: Yeniden adlandırın ve çalıştırılabilir yapın

Git kancaları, çalıştıkları yere göre iki ana türe ayrılır:

• İstemci Tarafı Kancaları: Yerel makinenizde çalışır (örneğin, işleme oluşturmadan veya yeniden temel almadan önce). Kişisel iş akışı otomasyonu ve yerel ilkeleri uygulamak için kullanılır.
• Sunucu Tarafı Kancaları: Uzak Git sunucusunda çalışır (örneğin, kodu paylaşılan bir depoya gönderdiğinizde). Proje genelindeki ilkeleri herkes için uygular.

pre-commit kancası, en yaygın istemci tarafı kancalarından biridir. Git bir işlemeyi resmen oluşturmadan *önce* çalışır.

pre-commit betiği sıfır olmayan bir durumla sonlanırsa Git işlemeyi iptal eder. Bu kanca şu görevler için idealdir:

• Kod stili denetimi (biçimlendirme hatalarını kontrol etme)
• Birim testlerini çalıştırma
• Büyük dosyaları veya hassas verileri kontrol etme

commit-msg kancası, işleme iletinizi girdikten *sonra* ancak işleme kesinleştirilmeden *önce* çalışır.

Bu kanca, işleme iletilerinizin belirli kurallara veya biçimlere uymasını sağlamak için kullanışlıdır. Örneğin şunları kontrol edebilir:

• İletinin bir iş kimliğiyle başlayıp başlamadığını (örneğin, [JIRA-123])
• İleti uzunluğunun sınırlar içinde olup olmadığını
• Belirli anahtar kelimelerin bulunup bulunmadığını

post-commit kancası, bir işleme başarıyla oluşturulduktan *hemen sonra* çalışır.

pre-commit veya commit-msg'den farklı olarak bu kanca, işlemenin sonucunu değiştiremez. Genellikle bildirim veya bütünleştirme amacıyla kullanılır; örneğin:

• Ekip üyelerine bildirim gönderme
• Bir proje yönetimi aracını güncelleme
• Sürekli tümleştirme (CI) derlemesini tetikleme (bu işlem sunucu tarafı kancalarında daha yaygındır)

Sunucu tarafı kancalarına geçtiğimizde, pre-receive uzak depodaki herhangi bir başvuru (dallar veya etiketler gibi) güncellenmeden önce çalıştırılır.

Bu kanca, aşağıdakiler gibi önemli depo ilkelerini zorunlu kılmak için oldukça etkilidir:

• main dalına doğrudan gönderme yapılmasını önleme
• Tüm işlemelerin imzalandığından emin olma
• İşlemeyi yapan kişinin kimliğini doğrulama

Bu kanca sıfır olmayan bir çıkış koduyla sonlanırsa gönderme işleminin tamamı reddedilir.

post-receive kancası, bir gönderme işlemi uzak depodaki başvuruları başarıyla güncelledikten sonra çalışır.

post-commit kancasına benzer şekilde, bu kanca gönderme işlemini reddedemez. Genellikle şu amaçlarla kullanılır:

• Sürekli tümleştirme/sürekli teslim pipeline'larını tetikleme
• Harici sorun takip sistemlerini güncelleme
• Ekibe e-posta bildirimleri gönderme
• Kodu bir hazırlık ortamına dağıtma

Bir kanca oluşturmak için kancanın adıyla (örneğin pre-commit) bir dosya oluşturup bunu .git/hooks/ dizininize yerleştirmeniz yeterlidir. Çok temel bir kanca oluşturalım:

Kanca betiğinizi oluşturduktan sonra onu çalıştırılabilir hâle getirmeniz gerekir. Aksi takdirde Git onu çalıştırmaz. Terminalinizde chmod komutunu kullanın:

chmod +x .git/hooks/pre-commit

Artık her işlemeyi gerçekleştirmeyi denediğinizde Git bu betiği çalıştıracaktır!

Git kancaları iş akışınızın belirli noktalarında çalışır. Zamanlamalarını anlamak, kancaları etkili biçimde kullanmanın anahtarıdır.

Git kancalarının güçlü dünyasına ilk adımı attınız!

• Git kancaları, Git olayları sırasında eylemleri otomatikleştiren betiklerdir.
• Deponuzun .git/hooks/ dizininde bulunurlar.
• Kancalar ya istemci tarafı (yerel makine) ya da sunucu tarafı (uzak depo) olur.
• pre-commit ve pre-receive gibi temel kancalar, işlemleri engelleyerek ilkeleri zorunlu kılabilir.
• post-commit ve post-receive gibi kancalar, işlem sonrası bildirimler veya tümleştirmeler içindir.

Sırada, belirli kancalara ilişkin uygulamalı örnekleri hayata geçirmeyi inceleyeceğiz!