チャプター ▾ 第2版

2.6 Git の基本 - タグ

タグ

ほとんどの VCS と同様に、Git にはリポジトリの履歴における特定のポイントを重要なものとしてタグ付けする機能があります。通常、この機能はリリースポイント (v1.0、v2.0 など) をマークするために使用されます。このセクションでは、既存のタグを一覧表示する方法、タグを作成および削除する方法、および異なる種類のタグについて学びます。

タグを一覧表示する

Git の既存のタグを一覧表示するのは簡単です。git tag (オプションの -l または --list を付けて) と入力するだけです。

$ git tag
v1.0
v2.0

このコマンドはタグをアルファベット順に一覧表示します。表示順序に実質的な重要性はありません。

特定のパターンに一致するタグを検索することもできます。たとえば、Git のソースリポジトリには 500 以上のタグが含まれています。1.8.5 シリーズのみに関心がある場合は、これを実行できます。

$ git tag -l "v1.8.5*"
v1.8.5
v1.8.5-rc0
v1.8.5-rc1
v1.8.5-rc2
v1.8.5-rc3
v1.8.5.1
v1.8.5.2
v1.8.5.3
v1.8.5.4
v1.8.5.5
注
タグのワイルドカードを一覧表示するには、-l または --list オプションが必要です。

タグの完全なリストだけが必要な場合、git tag コマンドを実行すると、暗黙的にリストが必要であると見なされ、提供されます。この場合、-l または --list の使用はオプションです。

ただし、タグ名に一致するワイルドカードパターンを指定する場合は、-l または --list の使用が必須です。

タグを作成する

Git は、軽量タグと注釈付きタグの 2 種類のタグをサポートしています。

軽量タグは、変更されないブランチに非常に似ています。特定のコミットへの単なるポインタです。

ただし、注釈付きタグは、Git データベースに完全なオブジェクトとして保存されます。これらはチェックサムされ、タグ作成者の名前、メール、日付が含まれ、タグ付けメッセージを持ち、GNU Privacy Guard (GPG) で署名および検証できます。通常、これらすべての情報を持つために注釈付きタグを作成することをお勧めします。ただし、一時的なタグが必要な場合や、何らかの理由で他の情報を保持したくない場合は、軽量タグも利用できます。

注釈付きタグ

Git で注釈付きタグを作成するのは簡単です。最も簡単な方法は、tag コマンドを実行するときに -a を指定することです。

$ git tag -a v1.4 -m "my version 1.4"
$ git tag
v0.1
v1.3
v1.4

-m はタグとともに保存されるタグ付けメッセージを指定します。注釈付きタグにメッセージを指定しない場合、Git はエディタを起動してメッセージを入力できるようにします。

git show コマンドを使用して、タグ付けされたコミットとともにタグデータを確認できます。

$ git show v1.4
tag v1.4
Tagger: Ben Straub <ben@straub.cc>
Date:   Sat May 3 20:19:12 2014 -0700

my version 1.4

commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

    Change version number

これにより、タグ作成者情報、コミットがタグ付けされた日付、および注釈メッセージが表示され、その後にコミット情報が表示されます。

軽量タグ

コミットにタグを付けるもう 1 つの方法は、軽量タグを使用することです。これは基本的に、ファイルに保存されたコミットのチェックサムであり、他の情報は保持されません。軽量タグを作成するには、-a、-s、または -m オプションを何も指定せず、タグ名のみを指定します。

$ git tag v1.4-lw
$ git tag
v0.1
v1.3
v1.4
v1.4-lw
v1.5

このとき、タグに対して git show を実行しても、追加のタグ情報は表示されません。コマンドはコミットのみを表示します。

$ git show v1.4-lw
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

    Change version number

後でタグ付けする

コミットを通過した後でもタグ付けできます。コミット履歴が次のようになっているとします。

$ git log --pretty=oneline
15027957951b64cf874c3557a0f3547bd83b3ff6 Merge branch 'experiment'
a6b4c97498bd301d84096da251c98a07c7723e65 Create write support
0d52aaab4479697da7686c15f77a3d64d9165190 One more thing
6d52a271eda8725415634dd79daabbc4d9b6008e Merge branch 'experiment'
0b7434d86859cc7b8c3d5e1dddfed66ff742fcbc Add commit function
4682c3261057305bdd616e23b64b0857d832627b Add todo file
166ae0c4d3f420721acbb115cc33848dfcc2121a Create write support
9fceb02d0ae598e95dc970b74767f19372d61af8 Update rakefile
964f16d36dfccde844893cac5b347e7b3d44abbc Commit the todo
8a5cbc430f1a9c3d00faaeffd07798508422908a Update readme

今、"Update rakefile" コミットの v1.2 でプロジェクトにタグを付け忘れたとします。後から追加できます。そのコミットにタグを付けるには、コマンドの最後にコミットのチェックサム (またはその一部) を指定します。

$ git tag -a v1.2 9fceb02

コミットにタグを付けたことがわかります。

$ git tag
v0.1
v1.2
v1.3
v1.4
v1.4-lw
v1.5

$ git show v1.2
tag v1.2
Tagger: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Feb 9 15:32:16 2009 -0800

version 1.2
commit 9fceb02d0ae598e95dc970b74767f19372d61af8
Author: Magnus Chacon <mchacon@gee-mail.com>
Date:   Sun Apr 27 20:43:35 2008 -0700

    Update rakefile
...

タグを共有する

デフォルトでは、git push コマンドはタグをリモートサーバーに転送しません。タグを作成したら、明示的に共有サーバーにプッシュする必要があります。このプロセスはリモートブランチの共有とまったく同じです。git push origin <tagname> を実行できます。

$ git push origin v1.5
Counting objects: 14, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (12/12), done.
Writing objects: 100% (14/14), 2.05 KiB | 0 bytes/s, done.
Total 14 (delta 3), reused 0 (delta 0)
To git@github.com:schacon/simplegit.git
 * [new tag]         v1.5 -> v1.5

一度に多数のタグをプッシュしたい場合は、git push コマンドに --tags オプションを使用することもできます。これにより、まだリモートサーバーに存在しないすべてのタグがリモートサーバーに転送されます。

$ git push origin --tags
Counting objects: 1, done.
Writing objects: 100% (1/1), 160 bytes | 0 bytes/s, done.
Total 1 (delta 0), reused 0 (delta 0)
To git@github.com:schacon/simplegit.git
 * [new tag]         v1.4 -> v1.4
 * [new tag]         v1.4-lw -> v1.4-lw

これで、他の誰かがリポジトリをクローンまたはプルすると、あなたのすべてのタグも取得されます。

注
git push は両方の種類のタグをプッシュします

git push <remote> --tags は、軽量タグと注釈付きタグの両方をプッシュします。現在、軽量タグのみをプッシュするオプションはありませんが、git push <remote> --follow-tags を使用すると、注釈付きタグのみがリモートにプッシュされます。

タグを削除する

ローカルリポジトリからタグを削除するには、git tag -d <tagname> を使用できます。たとえば、上記の軽量タグを次のように削除できます。

$ git tag -d v1.4-lw
Deleted tag 'v1.4-lw' (was e7d5add)

これはリモートサーバーからタグを削除しないことに注意してください。リモートサーバーからタグを削除するには、2 つの一般的なバリエーションがあります。

最初のバリエーションは git push <remote> :refs/tags/<tagname> です。

$ git push origin :refs/tags/v1.4-lw
To /git@github.com:schacon/simplegit.git
 - [deleted]         v1.4-lw

上記の解釈は、コロンの前の null 値がリモートタグ名にプッシュされ、効果的に削除されると読み取ることです。

リモートタグを削除する 2 番目の (より直感的な) 方法は次のとおりです。

$ git push origin --delete <tagname>

タグをチェックアウトする

タグが指すファイルのバージョンを表示したい場合は、そのタグを git checkout できますが、これによりリポジトリが「detached HEAD」状態になり、いくつかの悪影響があります。

$ git checkout v2.0.0
Note: switching to 'v2.0.0'.

You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by performing another checkout.

If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -c with the switch command. Example:

  git switch -c <new-branch-name>

Or undo this operation with:

  git switch -

Turn off this advice by setting config variable advice.detachedHead to false

HEAD is now at 99ada87... Merge pull request #89 from schacon/appendix-final

$ git checkout v2.0-beta-0.1
Previous HEAD position was 99ada87... Merge pull request #89 from schacon/appendix-final
HEAD is now at df3f601... Add atlas.json and cover image

「detached HEAD」状態では、変更を行ってコミットを作成しても、タグは同じままですが、新しいコミットはどのブランチにも属さず、正確なコミットハッシュを除いて到達不能になります。したがって、変更を行う必要がある場合、たとえば古いバージョンでバグを修正している場合など、通常はブランチを作成する必要があります。

$ git checkout -b version2 v2.0.0
Switched to a new branch 'version2'

これを行ってコミットを作成すると、version2 ブランチは新しい変更で進むため、v2.0.0 タグとはわずかに異なります。そのため、注意が必要です。

scroll-to-top