7.12 Git Araçları - Demetleme (Bundling)

Git verisini ağ üzerinden aktarmanın yaygın yollarını (HTTP, SSH, vb.) öğrendik, ancak aslında pek kullanılmayan fakat oldukça yararlı olabilen başka bir yol daha vardır.

Git, verisini tek bir dosya halinde "demetleyebilir" ve bu, çeşitli senaryolarda faydalı olabilir. Belki ağınız kapalıdır ama değişikliklerinizi iş arkadaşlarınıza göndermek istiyorsunuz. Belki dışarıda bir yerde çalışıyorsunuz ve güvenlik nedeniyle yerel ağa erişiminiz yoktur. Belki sadece kablosuz/eternet kartınız bozulmuştur. Belki şu anda paylaşılan bir sunucuya erişiminiz yok ve birine güncellemeleri e-posta ile göndermek istersiniz ama format-patch ile 40 değişikliği aktarmak istemiyorsunuzdur.

İşte burada git bundle komutunun yardımcı olabileceği yer vardır. bundle komutu, bir git push komutuyla normalde ağ üzerinden gönderilecek her şeyi ikilik (binary) bir dosya demeti haline getirecektir. Bu dosyayı birine e-posta ile gönderebilir veya bir taşınabilir sürücüye koyup, ardından başka bir repoda açabilirsiniz.

Basit bir örnek görelim. İki katkı işlenmiş olan bir repoya sahip olduğunuzu varsayalım:

Eğer o repoyu birine göndermek istiyorsanız ama gönderilecek repoya erişiminiz yoksa veya hemen bir tane kurmak istemiyorsanız, git bundle create ile demetleyebilirsiniz.

Artık, repoyu yeniden oluşturmak için gereken tüm verilere sahip repo.bundle adında bir dosyanız var. bundle komutu ile dahil edilmesini istediğiniz her referansı veya belirli bir değişiklik aralığını belirtmeniz gerekir. Eğer bunu başka bir yere kopyalamak niyetindeyseniz, burada yaptığımız gibi HEAD’i de bir referans olarak eklemelisiniz.

Bu repo.bundle dosyasını başka birine e-posta ile gönderebilir veya USB sürücüsüne koyarak ulaştırabilirsiniz.

Bunun yanında, diyelim ki bu repo.bundle dosyası size gönderildi ve projede çalışmak istiyorsunuz. Bu ikilik dosyayı, sanki URL’den klonlama yapar gibi, bir dizine kopyalayabilirsiniz.

Eğer referanslara HEAD’i dahil etmezseniz, -hangi dala geçileceğini bilemeyeceği için- -b master veya içerilen herhangi bir dalı belirtmeniz gerekir.

Şimdi diyelim ki üç adet değişiklik yaptınız ve bunları bir USB sürücüsü veya e-posta ile geri göndermek istiyorsunuz.

Öncelikle, demete dahil etmek istediğimiz değişiklik aralığını belirlememiz gerekiyor. Ağ üzerinde aktarılacak minimum veri kümesini otomatik olarak belirleyen ağ protokollerinin aksine, bunu manuel olarak kendimiz belirlememiz gerekecek. Şimdi, doğrudan tüm repoyu demetlemek işe yarayacak olsa da lokal olarak yaptığımız üç değişikliği içeren farkı demetlemek daha iyidir.

Bunu yapabilmek için farkı hesaplamanız gerekecek. Katkı Aralığı bölümünde açıkladığımız gibi, bir dizi değişiklik aralığını belirtmek için birkaç yol vardır. Başta kopyaladığımız dalda bulunmayıp, artık master dalımızda olan üç değişikliği almak için origin/master..master veya master ^origin/master gibi bir şey kullanabilirsiniz. Bu işlemi log komutuyla test edebilirsiniz.

Şimdi demete dahil etmek istediğimiz değişikliklerin listesine sahip olduğumuza göre, onları demetleyelim. Bunu, git bundle create` komutunu kullanarak yaparız; bunu yaparken demetimizin dosya adını ve eklemek istediğimiz katkıların aralığını veririz.

Şimdi dizinimizde bir commits.bundle dosyasına sahibiz. Bu dosyayı alıp arkadaşımıza gönderirsek, geçen zaman zarfında dosya üzerinde daha fazla çalışma yapılmış olsa bile, bunu orijinal repoya aktarabilir.

Arkadaşımız bu demeti aldığında, onu reposuna aktarmadan önce içerdiğini görmek için inceleyebilir. İlk komut, dosyanın gerçekten geçerli bir Git demeti olduğundan ve bunu doğru şekilde yeniden oluşturmak için gerekli tüm eklere sahip olduğunuzdan emin olmak için bundle verify komutudur.

Eğer demetleyici, tüm üç değişiklik yerine, yalnızca yaptıkları son iki değişikliğin bir demetini oluşturmuş olsaydı, gerekli tarihlerden biri eksik olacağı için, orijinal repo bunu alamazdı. verify komutu ise şu şekilde görünecekti:

Ancak, ilk demetimiz geçerlidir, bu yüzden ondaki değişiklikleri çekebiliriz. İçeri aktarılabilen demette hangi dalların olduğunu görmek isterseniz, yalnızca uçları (HEAD) listelemek için bir komutumuz da mevcuttur:

verify alt komutu aynı zamanda başlıkları da size söyleyecektir. Amacımız içe aktarılabilenleri görmektir, haliyle bu demetten değişiklikleri almak için fetch veya pull komutlarını kullanabilirsiniz. Şimdi demetin master dalını, repomuzdaki other-master adlı bir dala almak için fetch komutunu kullanıyoruz:

Şimdi, other-master dalında alınan değişiklikleri, kendi master dalımızda yaptığımız tüm değişikliklerle birlikte görebiliriz.

Gördüğünüz gibi, git bundle uygun ağa veya paylaşılan bir repoya sahip olmadığınızda paylaşım yapmak veya ağ benzeri işlemler gerçekleştirmek için gerçekten yararlı olabilir.