Git
章 ▾ 第2版

7.12 Gitツール - バンドル

バンドル

これまで、ネットワーク（HTTP、SSHなど）経由でGitデータを転送する一般的な方法について説明してきましたが、実際には、あまり一般的ではないものの、非常に便利な別の方法があります。

Gitは、データを単一のファイルに「バンドル」することができます。これは、さまざまなシナリオで役立ちます。ネットワークがダウンしていて、同僚に変更を送信したい場合。オフサイトで作業していて、セキュリティ上の理由からローカルネットワークにアクセスできない場合。ワイヤレス/イーサネットカードが壊れてしまった場合。共有サーバーにアクセスできないときに、メールで更新を送信したいが、format-patch経由で40個のコミットを転送したくない場合など。

このような場合に、git bundleコマンドが役立ちます。bundleコマンドは、通常git pushコマンドでネットワーク経由でプッシュされるすべてのデータを、メールで送信したり、フラッシュドライブに保存したりできるバイナリファイルにパッケージ化します。その後、別のリポジトリにアンバンドルできます。

簡単な例を見てみましょう。2つのコミットを持つリポジトリがあるとします。

$ 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

そのリポジトリを誰かに送信したいが、プッシュするリポジトリにアクセスできない場合、または単に設定したくない場合は、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)

これで、リポジトリのmasterブランチを再作成するために必要なすべてのデータを含むrepo.bundleという名前のファイルができました。bundleコマンドでは、含めるすべての参照または特定のコミット範囲をリストする必要があります。これを別の場所にクローンする予定の場合は、ここで行ったように、参照としてHEADも追加する必要があります。

このrepo.bundleファイルを他の人にメールで送信するか、USBドライブに保存して持ち歩くことができます。

一方、このrepo.bundleファイルが送られてきて、プロジェクトに取り組みたいとします。URLからクローンする場合と同様に、バイナリファイルからディレクトリにクローンできます。

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

参照にHEADを含めない場合は、-b masterまたは含まれているブランチを指定する必要があります。そうしないと、どのブランチをチェックアウトすればよいかわかりません。

次に、3つのコミットを行い、新しいコミットをUSBスティックまたはメールのバンドル経由で送り返したいとします。

$ git log --oneline
71b84da Last commit - second repo
c99cf5b Fourth commit - second repo
7011d3d Third commit - second repo
9a466c5 Second commit
b1ec324 First commit

まず、バンドルに含めるコミットの範囲を決定する必要があります。ネットワーク経由で転送する最小限のデータセットを自動的に判断してくれるネットワークプロトコルとは異なり、これを手動で判断する必要があります。もちろん、同じことを行ってリポジトリ全体をバンドルすることもできますが、それも機能します。しかし、差分だけ、つまりローカルで行った3つのコミットだけをバンドルする方が良いでしょう。

そのためには、差分を計算する必要があります。「コミット範囲」で説明したように、コミット範囲はさまざまな方法で指定できます。最初にクローンしたブランチにはなかったmasterブランチにある3つのコミットを取得するには、origin/master..masterまたはmaster ^origin/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コマンドを使用し、バンドルするファイル名と、その中に入れるコミット範囲を指定します。

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

これで、ディレクトリにcommits.bundleファイルができました。このファイルをパートナーに送信すると、パートナーは、たとえその間に元のリポジトリでさらに作業が行われていたとしても、それを元のリポジトリにインポートできます。

彼女がバンドルを受け取ったら、リポジトリにインポートする前に、その内容を調べて確認できます。最初のコマンドは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

もしバンドル作成者が、3つすべてではなく、最後の2つのコミットのみのバンドルを作成した場合、元のリポジトリは、必要な履歴がないため、インポートできません。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

これで、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

このように、git bundleは、適切なネットワークや共有リポジトリがない場合に、ネットワーク型の操作を共有したり実行したりするのに非常に役立ちます。

scroll-to-top