2013年03月29日

Git で複数ブランチを同時に扱いたいなら git-new-workdir が便利

Git で管理してるレポジトリーで、いくつかのブランチを別々の場所にチェックアウトしたいことがある。

たとえば

といったときに、必要になる。

ブランチの個数だけ clone しちゃえば用は足りそうなんだけど、でかいレポジトリーだったら時間もディスク容量ももったいない。

git-new-workdir を使うべきでしょう！

先日、「git-new-workdir を使えばワーキングディレクトリーを複数を作れて便利」と書いてあるブログを読んだ。

git-new-workdir の usage を見てたら、別ブランチのワーキングディレクトリー作成にも対応しているらしい！

git-new-workdir <repository> <new_workdir> [<branch>]

これは活用しない手はない。

(追記) Git 2.5 では worktree コマンドが正式に導入されたので、そちらを使うのがお勧めです。詳しくは Git 2.x シリーズの 6 つの素晴らしいフィーチャー - Atlassian Japan をご覧ください。

master ブランチで作業しているとして、develop ブランチの中身も展開したいと思ったとする。

git-new-workdir . ../foo-develop develop

これだけで ../foo-develop に develop ブランチの中身を展開してくれる。

展開の処理に工夫があって、ワーキングディレクトリーとステージ (インデックス) は独立なんだけど、コミット履歴などはシンボリックリンクで共有されている。

だから、ワーキングディレクトリーの中身を比較できるのはもちろん、別々の場所で編集してコミットしてもよい。片方でコミットした内容は、もう片方で git log すれば表示できる。

git push すれば master と develop の両方の変更を一気に push できる。別々に clone していたらありえない。

もちろん、git fetch も、どちらか一方で実行すれば、もう片方も最新の状態になってる。

いろいろ便利でハッピー！

GitHub Pages を使うときにはありがちなんだけど、ドキュメントの生成結果を別ブランチにコミットする。このブログでは、Jekyll でサイト生成した結果を別ブランチにコミットしている (詳しくは俺の最強ブログシステムが火を噴くぜ参照)。

このようなケースには、サブモジュールを使うテクニックが知られている。

このテクニックは一見便利そうなんだけども、使っているうちに不便なところが目に付いてきた・・・。

同じレポジトリーを 2 回 clone するので非効率的。
2 つの作業ディレクトリーのそれぞれで push, pull しなきゃいけない。
ドキュメントのディレクトリーでコミットするたびに、submodule が更新された状態になる。それを放置してると、submodule init した人が古い状態のツリーを参照してしまうので、定期的にコミットして、サブモジュールの指す先を更新する必要がある。

サブモジュールはそもそも別の Git レポジトリーを管理するために設計されたものだし、同じレポジトリーをサブモジュールとして持つのはいろいろ弊害あるように思う。

で、サブモジュールに困っていたところで、git-new-workdir を使ってみたら便利だった。

開発用ブランチが master で、ドキュメントのブランチが gh-pages だとして、gh-pages ディレクトリーに gh-pages ブランチの中身をチェックアウトする。

git-new-workdir . gh-pages gh-pages

これで、Git レポジトリー直下の gh-pages ディレクトリーに gh-pages ブランチがチェックアウトされた。間違ってディレクトリーの中身をコミットしないように .gitignore に gh-pages を入れておくと安全だろう。

あとは個別のディレクトリーで編集してコミットしていく。先ほどの例と同じく、片方でコミットした内容は、もう片方の作業ディレクトリーで git log すれば反映されるし、git push すれば一気にリモートに反映される。

便利便利である。

git-new-workdir は git-core の contrib に入っている。詳しくは git-new-workdir が便利 - #生存戦略、それは - subtech を参照。

ただ、Windows で Git for Windows (msysGit) を使ってる場合は、そのまま持ってきても動かないので、次のようにした。

git/contrib/workdir/git-new-workdir-win at master - dansmith65/git から git-new-workdir-win を拾ってくる。
C:\Program Files (x86)\Git\libexec\git-core に git-new-workdir としてコピーする。(x86 環境なら Program Files (x86) を Program Files に読み替えるべし)

これでおしまい。ただし、mklink.exe を使う関係で、UAC 有効にしてる環境では、bash を管理者として実行しておかないと、権限が足りなくてエラーになるので注意すべし。

git-new-workdir で便利な Git 生活を！