章 ▾ 第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

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

$ 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