7.12 打包

打包

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

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

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

來看看一個簡單的例子。 假設你有一個包含兩個提交的倉庫：

$ 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

如果你想把這個倉庫發(fā)送給其他人但你沒有其他倉庫的權限，或者就是懶得新建一個倉庫，你就可以用git bundle create?命令來打包。

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

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

你可以將這個?repo.bundle?文件通過郵件或者U盤傳給別人。

另一方面，假設別人傳給你一個?repo.bundle?文件并希望你在這個項目上工作。 你可以從這個二進制文件中克隆出一個目錄，就像從一個 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

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

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

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

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

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

$ 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)在在我們的目錄下會有一個?commits.bundle?文件。 如果我們把這個文件發(fā)送給我們的合作者，她可以將這個文件導入到原始的倉庫中，即使在這期間已經(jīng)有其他的工作提交到這個倉庫中。

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

$ 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

如果打包工具僅僅把最后兩個提交打包，而不是三個，原始的倉庫是無法導入這個包的，因為這個包缺失了必要的提交記錄。這時候?verify?的輸出類似：

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

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

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

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

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

可以看到我們已經(jīng)將提交導入到?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

因此，當你在沒有合適的網(wǎng)絡或者可共享倉庫的情況下，git bundle?很適合用于共享或者網(wǎng)絡類型的操作。