7.12 打包

打包

雖然我們已經(jīng)了解了網(wǎng)絡(luò)傳輸 Git 數(shù)據(jù)的常用方法（如 HTTP，SSH 等），但還有另外一種不太常見(jiàn)卻又十分有用的方式。

Git 可以將它的數(shù)據(jù) “打包” 到一個(gè)文件中。 這在許多場(chǎng)景中都很有用。 有可能你的網(wǎng)絡(luò)中斷了，但你又希望將你的提交傳給你的合作者們。 可能你不在辦公網(wǎng)中并且出于安全考慮沒(méi)有給你接入內(nèi)網(wǎng)的權(quán)限。 可能你的無(wú)線(xiàn)、有線(xiàn)網(wǎng)卡壞掉了。 可能你現(xiàn)在沒(méi)有共享服務(wù)器的權(quán)限，你又希望通過(guò)郵件將更新發(fā)送給別人，卻不希望通過(guò)?format-patch?的方式傳輸 40 個(gè)提交。

這些情況下?git bundle?就會(huì)很有用。?bundle?命令會(huì)將?git push?命令所傳輸?shù)乃袃?nèi)容打包成一個(gè)二進(jìn)制文件，你可以將這個(gè)文件通過(guò)郵件或者閃存?zhèn)鹘o其他人，然后解包到其他的倉(cāng)庫(kù)中。

來(lái)看看一個(gè)簡(jiǎn)單的例子。 假設(shè)你有一個(gè)包含兩個(gè)提交的倉(cāng)庫(kù)：

$ 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

如果你想把這個(gè)倉(cāng)庫(kù)發(fā)送給其他人但你沒(méi)有其他倉(cāng)庫(kù)的權(quán)限，或者就是懶得新建一個(gè)倉(cāng)庫(kù)，你就可以用git bundle create?命令來(lái)打包。

$ 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)

然后你就會(huì)有一個(gè)名為?repo.bundle?的文件，該文件包含了所有重建該倉(cāng)庫(kù)?master?分支所需的數(shù)據(jù)。 在使用?bundle?命令時(shí)，你需要列出所有你希望打包的引用或者提交的區(qū)間。 如果你希望這個(gè)倉(cāng)庫(kù)可以在別處被克隆，你應(yīng)該像例子中那樣增加一個(gè) HEAD 引用。

你可以將這個(gè)?repo.bundle?文件通過(guò)郵件或者U盤(pán)傳給別人。

另一方面，假設(shè)別人傳給你一個(gè)?repo.bundle?文件并希望你在這個(gè)項(xiàng)目上工作。 你可以從這個(gè)二進(jìn)制文件中克隆出一個(gè)目錄，就像從一個(gè) URL 克隆一樣。

$ git clone repo.bundle repo
Initialized empty Git repository in /private/tmp/bundle/repo/.git/
$ cd repo
$ git log --oneline
9a466c5 second commit
b1ec324 first commit

如果你在打包時(shí)沒(méi)有包含 HEAD 引用，你還需要在命令后指定一個(gè)?-b master?或者其他被引入的分支，否則 Git 不知道應(yīng)該檢出哪一個(gè)分支。

現(xiàn)在假設(shè)你提交了 3 個(gè)修訂，并且要用郵件或者U盤(pán)將新的提交放在一個(gè)包里傳回去。

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

首先我們需要確認(rèn)我們希望被打包的提交區(qū)間。 和網(wǎng)絡(luò)協(xié)議不太一樣，網(wǎng)絡(luò)協(xié)議會(huì)自動(dòng)計(jì)算出所需傳輸?shù)淖钚?shù)據(jù)集，而我們需要手動(dòng)計(jì)算。 當(dāng)然你可以像上面那樣將整個(gè)倉(cāng)庫(kù)打包，但最好僅僅打包變更的部分 —— 就是我們剛剛在本地做的 3 個(gè)提交。

為了實(shí)現(xiàn)這個(gè)目標(biāo)，你需要計(jì)算出差別。 就像我們?cè)?提交區(qū)間?介紹的，你有很多種方式去指明一個(gè)提交區(qū)間。 我們可以使用?origin/master..master?或者?master ^origin/master?之類(lèi)的方法來(lái)獲取那 3 個(gè)在我們的 master 分支而不在原始倉(cāng)庫(kù)中的提交。 你可以用?log?命令來(lái)測(cè)試。

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

這樣就獲取到我們希望被打包的提交列表，讓我們將這些提交打包。 我們可以用?git bundle create?命令，加上我們想用的文件名，以及要打包的提交區(qū)間。

$ 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)

現(xiàn)在在我們的目錄下會(huì)有一個(gè)?commits.bundle?文件。 如果我們把這個(gè)文件發(fā)送給我們的合作者，她可以將這個(gè)文件導(dǎo)入到原始的倉(cāng)庫(kù)中，即使在這期間已經(jīng)有其他的工作提交到這個(gè)倉(cāng)庫(kù)中。

當(dāng)她拿到這個(gè)包時(shí)，她可以在導(dǎo)入到倉(cāng)庫(kù)之前查看這個(gè)包里包含了什么內(nèi)容。?bundle verify?命令可以檢查這個(gè)文件是否是一個(gè)合法的 Git 包，是否擁有共同的祖先來(lái)導(dǎo)入。

$ 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

如果打包工具僅僅把最后兩個(gè)提交打包，而不是三個(gè)，原始的倉(cāng)庫(kù)是無(wú)法導(dǎo)入這個(gè)包的，因?yàn)檫@個(gè)包缺失了必要的提交記錄。這時(shí)候?verify?的輸出類(lèi)似：

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

而我們的第一個(gè)包是合法的，所以我們可以從這個(gè)包里提取出提交。 如果你想查看這邊包里可以導(dǎo)入哪些分支，同樣有一個(gè)命令可以列出這些頂端：

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

verify?子命令同樣可以告訴你有哪些頂端。 該功能的目的是查看哪些是可以被拉入的，所以你可以使用?fetch?或者?pull?命令從包中導(dǎo)入提交。 這里我們要從包中取出?master?分支到我們倉(cāng)庫(kù)中的?other-master?分支：

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

可以看到我們已經(jīng)將提交導(dǎo)入到?other-master?分支，以及在這期間我們自己在?master?分支上的提交。

$ 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

因此，當(dāng)你在沒(méi)有合適的網(wǎng)絡(luò)或者可共享倉(cāng)庫(kù)的情況下，git bundle?很適合用于共享或者網(wǎng)絡(luò)類(lèi)型的操作。