チャプター ▾ 第2版

10.3 Git Internals - Git References

Git References

例えば、コミット1a410eから到達可能なリポジトリの履歴を見たい場合、git log 1a410eのようなコマンドを実行して履歴を表示することができますが、その履歴の開始点として使用したいコミットが1a410eであることを覚えておく必要があります。代わりに、そのSHA-1値を単純な名前で保存できるファイルがあれば、生のSHA-1値の代わりにその単純な名前を使用できるので、より簡単になります。

Gitでは、これらの単純な名前を「参照 (references)」または「ref」と呼びます。これらのSHA-1値を含むファイルは.git/refsディレクトリにあります。現在のプロジェクトでは、このディレクトリにはファイルはありませんが、単純な構造を持っています。

$ find .git/refs
.git/refs
.git/refs/heads
.git/refs/tags
$ find .git/refs -type f

最新のコミットがどこにあるかを覚えておくのに役立つ新しい参照を作成するには、技術的には次のように簡単なことができます。

$ echo 1a410efbd13591db07496601ebc7a059dd55cfe9 > .git/refs/heads/master

これで、GitコマンドでSHA-1値の代わりに、今作成したhead参照を使用できます。

$ git log --pretty=oneline master
1a410efbd13591db07496601ebc7a059dd55cfe9 Third commit
cac0cab538b970a37ea1e769cbbde608743bc96d Second commit
fdf4fc3344e67ab068f836878b6c4951e3b15f3d First commit

参照ファイルを直接編集することはお勧めしません。代わりに、Gitは参照を更新したい場合に安全なコマンドgit update-refを提供しています。

$ git update-ref refs/heads/master 1a410efbd13591db07496601ebc7a059dd55cfe9

これがGitにおけるブランチの基本的な仕組みです。作業ラインの先端への単純なポインタ、または参照です。2番目のコミットに戻るブランチを作成するには、次のようにします。

$ git update-ref refs/heads/test cac0ca

あなたのブランチには、そのコミット以降の作業のみが含まれます。

$ git log --pretty=oneline test
cac0cab538b970a37ea1e769cbbde608743bc96d Second commit
fdf4fc3344e67ab068f836878b6c4951e3b15f3d First commit

これで、あなたのGitデータベースは概念的に次のようになります。

Git directory objects with branch head references included
図176. ブランチヘッド参照を含むGitディレクトリのオブジェクト

git branch のようなコマンドを実行すると、Gitは基本的にそのupdate-refコマンドを実行して、現在のブランチの最後のコミットのSHA-1を、作成したい新しい参照に追加します。

HEAD

さて、git branch を実行するとき、Gitはどのようにして最後のコミットのSHA-1を知るのでしょうか？その答えはHEADファイルです。

通常、HEADファイルは現在いるブランチへのシンボリック参照です。シンボリック参照とは、通常の参照とは異なり、別の参照へのポインタを含んでいることを意味します。

ただし、まれにHEADファイルにGitオブジェクトのSHA-1値が含まれる場合があります。これは、タグ、コミット、またはリモートブランチをチェックアウトしたときに発生し、リポジトリが「分離されたHEAD」状態になります。

ファイルを見ると、通常は次のような内容が表示されます。

$ cat .git/HEAD
ref: refs/heads/master

git checkout testを実行すると、Gitはこのようにファイルを更新します。

$ cat .git/HEAD
ref: refs/heads/test

git commitを実行すると、コミットオブジェクトが作成され、そのコミットオブジェクトの親は、HEAD内の参照が指すSHA-1値として指定されます。

このファイルを手動で編集することもできますが、ここでもより安全なコマンドが存在します: git symbolic-ref。このコマンドでHEADの値を読み取ることができます。

$ git symbolic-ref HEAD
refs/heads/master

同じコマンドを使ってHEADの値を設定することもできます。

$ git symbolic-ref HEAD refs/heads/test
$ cat .git/HEAD
ref: refs/heads/test

refsの形式以外のシンボリック参照を設定することはできません。

$ git symbolic-ref HEAD test
fatal: Refusing to point HEAD outside of refs/

タグ

Gitの主要な3つのオブジェクトタイプ（blobs、trees、commits）について説明が終わったばかりですが、もう1つあります。タグオブジェクトはコミットオブジェクトによく似ています。タグ付け者、日付、メッセージ、ポインタを含みます。主な違いは、タグオブジェクトは通常、ツリーではなくコミットを指すことです。これはブランチ参照に似ていますが、決して移動せず、常に同じコミットを指しますが、より親しみやすい名前を与えます。

Git Basicsで説明したように、タグには注釈付きタグと軽量タグの2種類があります。次のようなコマンドを実行すると、軽量タグを作成できます。

$ git update-ref refs/tags/v1.0 cac0cab538b970a37ea1e769cbbde608743bc96d

軽量タグとは、移動しない参照です。しかし、注釈付きタグはより複雑です。注釈付きタグを作成すると、Gitはタグオブジェクトを作成し、それを直接コミットではなく、そのタグオブジェクトを指す参照を書き込みます。これは、注釈付きタグを作成することで確認できます（-aオプションを使用）。

$ git tag -a v1.1 1a410efbd13591db07496601ebc7a059dd55cfe9 -m 'Test tag'

これが作成されたオブジェクトのSHA-1値です。

$ cat .git/refs/tags/v1.1
9585191f37f7b0fb9444f35a9bf50de191beadc2

次に、そのSHA-1値に対してgit cat-file -pを実行します。

$ git cat-file -p 9585191f37f7b0fb9444f35a9bf50de191beadc2
object 1a410efbd13591db07496601ebc7a059dd55cfe9
type commit
tag v1.1
tagger Scott Chacon <schacon@gmail.com> Sat May 23 16:48:58 2009 -0700

Test tag

オブジェクトエントリがタグ付けしたコミットのSHA-1値を指していることに注目してください。また、コミットを指す必要がないことにも注目してください。任意のGitオブジェクトにタグを付けることができます。例えば、Gitのソースコードでは、メンテナがGPG公開鍵をblobオブジェクトとして追加し、それにタグを付けています。Gitリポジトリのクローンでこれを実行すると、公開鍵を見ることができます。

$ git cat-file blob junio-gpg-pub

Linuxカーネルのリポジトリにも、コミットを指さないタグオブジェクトがあります。最初に作成されたタグは、ソースコードのインポートの最初のツリーを指しています。

リモート

3番目の種類の参照は、リモート参照です。リモートを追加してそこにプッシュすると、Gitはrefs/remotesディレクトリ内の各ブランチについて、そのリモートに最後にプッシュした値を保存します。例えば、originというリモートを追加し、masterブランチをそれにプッシュすることができます。

$ git remote add origin git@github.com:schacon/simplegit-progit.git
$ git push origin master
Counting objects: 11, done.
Compressing objects: 100% (5/5), done.
Writing objects: 100% (7/7), 716 bytes, done.
Total 7 (delta 2), reused 4 (delta 1)
To git@github.com:schacon/simplegit-progit.git
  a11bef0..ca82a6d  master -> master

その後、サーバーと最後に通信したときのoriginリモートのmasterブランチがどうだったか、refs/remotes/origin/masterファイルを確認することで確認できます。

$ cat .git/refs/remotes/origin/master
ca82a6dff817ec66f44342007202690a93763949

リモート参照はブランチ（refs/heads参照）とは、主に読み取り専用である点で異なります。git checkoutでチェックアウトすることはできますが、GitはHEADをシンボリックに参照しないため、commitコマンドで更新することはありません。Gitは、これらのブランチがサーバー上にあった最後の既知の状態へのブックマークとして管理します。

scroll-to-top