10.5 Gitの内側 - Refspec

本書の全体に渡って、リモートブランチからローカルの参照へのシンプルなマッピングを使用してきましたが、もっと複雑な場合もあります。以下のようにリモートを追加したとしましょう。

.git/config ファイルにセクションを追加して、リモートの名前（origin）、リモートリポジトリのURL、そしてフェッチする対象のrefspecを指定します。

refspecの書式は <src>:<dst> で、その前にオプションとして {plus} を指定できます。ここで <src> はリモート側の参照に対するパターンで、 <dst> はそれらの参照がローカルで書きこまれる場所を示します。 {plus} は、fast-forwardでない場合でも参照を更新するようGitに指示しています。

デフォルトでは、 git remote add コマンドを実行すると、自動的にこの設定が書き込まれ、Gitはサーバー上の refs/heads/ 以下にあるすべての参照をフェッチして、ローカルの refs/remotes/origin/ に書き込みます。 そのため、サーバー上に master ブランチがあるとすると、ローカルでは、そのブランチのログには以下のコマンドでアクセスできます。

これらはすべて同じ意味を持ちます。なぜなら、どれもGitにより refs/remotes/origin/master に展開されるからです。

逆に、常にリモートサーバー上の master ブランチのみをプルして、それ以外のブランチはどれもプルしたくない場合は、fetchの行を以下のように変更します。

これは、このリモートに対する git fetch のデフォルトのrefspecそのものです。 もし、設定内容とは違う内容を一度だけプルしたければ、コマンドライン上でもrefspecを指定できます。 リモートの master ブランチを、ローカルの origin/mymaster にプルするには、以下のように実行します。

複数のrefspecを指定することも可能です。 コマンドライン上で、以下のように複数のブランチをプルできます。

このケースでは、 master ブランチのプルはfast-forwardの参照ではなかったため拒否されました。 refspecの先頭に {plus} を指定すると、この動作を上書きできます。

さらに、設定ファイルに、フェッチ用のrefspecを複数指定することもできます。 もし、常に master ブランチと experiment ブランチをフェッチしたいならば、以下のように2行追加します。

パターン中で、ファイル名の一部だけをワイルドカード指定したグロブを使うことはできません。以下の指定は無効となります。

しかし、名前空間（やディレクトリ）を使って、似たようなことは行えます。 一連のブランチをプッシュしてくれるQAチームがいたとして、masterブランチとQAチームのブランチのみを取得したいならば、該当セクションを以下のように使用すればよいでしょう。

仮に、QAチームがブランチをプッシュし、開発者チームもブランチをプッシュし、さらに統合チームもブランチをプッシュしたりリモートブランチを使って共同で作業をしたりするような複雑なワークフローに従っているとしましょう。そういった場合でも、上述のように設定しておけば簡単に名前空間を分けることができます。