Chapters ā–¾ 2nd Edition

7.12 Git AraƧları - Demetleme (Bundling)

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:

$ git log
commit 9a466c572fe88b195efd356c3f2bbeccdb504102
Author: Scott Chacon <schacon@gmail.com>
Date:   Wed Mar 10 07:34:10 2010 -0800

    second commit

commit b1ec3248f39900d2a406049d762aa68e9641be25
Author: Scott Chacon <schacon@gmail.com>
Date:   Wed Mar 10 07:34:01 2010 -0800

    first commit

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.

$ git bundle create repo.bundle HEAD master
Counting objects: 6, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (6/6), 441 bytes, done.
Total 6 (delta 0), reused 0 (delta 0)

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.

$ git clone repo.bundle repo
Cloning into 'repo'...
...
$ cd repo
$ git log --oneline
9a466c5 second commit
b1ec324 first commit

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.

$ git log --oneline
71b84da last commit - second repo
c99cf5b fourth commit - second repo
7011d3d third commit - second repo
9a466c5 second commit
b1ec324 first commit

Ɩ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.

$ git log --oneline master ^origin/master
71b84da last commit - second repo
c99cf5b fourth commit - second repo
7011d3d third commit - second repo

Ş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.

$ git bundle create commits.bundle master ^9a466c5
Counting objects: 11, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (9/9), 775 bytes, done.
Total 9 (delta 0), reused 0 (delta 0)

Ş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.

$ git bundle verify ../commits.bundle
The bundle contains 1 ref
71b84daaf49abed142a373b6e5c59a22dc6560dc refs/heads/master
The bundle requires these 1 ref
9a466c572fe88b195efd356c3f2bbeccdb504102 second commit
../commits.bundle is okay

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:

$ git bundle verify ../commits-bad.bundle
error: Repository lacks these prerequisite commits:
error: 7011d3d8fc200abe0ad561c011c3852a4b7bbe95 third commit - second repo

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:

$ git bundle list-heads ../commits.bundle
71b84daaf49abed142a373b6e5c59a22dc6560dc refs/heads/master

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:

$ git fetch ../commits.bundle master:other-master
From ../commits.bundle
 * [new branch]      master     -> other-master

Ş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.

$ git log --oneline --decorate --graph --all
* 8255d41 (HEAD, master) third commit - first repo
| * 71b84da (other-master) last commit - second repo
| * c99cf5b fourth commit - second repo
| * 7011d3d third commit - second repo
|/
* 9a466c5 second commit
* b1ec324 first commit

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.

scroll-to-top