git tag

新しいタグを作成するには次のコマンドを実行します。

を、タグが作成される時点のリポジトリの状態を示すセマンティック識別子に置換します。git tag v1.4 のようなバージョン番号を使うのが一般的なパターンです。Git では、注釈付きタグと軽量タグの、2 つの異なる種類のタグをサポートしています。先ほどのサンプルでは軽量タグを作成しました。軽量タグと注釈付きタグの違いは、タグに保存されるメタ データの量です。注釈付きタグはみんなで共有するもの、軽量タグは自分専用だと考えるとわかりやすいでしょう。注釈付きタグにはタグ付けプログラムの名前、メール、日付などのメタ データが保存されます。これらは公開リリースで重要になるデータです。軽量タグは本質的にはコミットの「ブックマーク」であり、コミットの名前とポインターに過ぎません。関連するコミットへのクイック リンクを作成するのに便利です。

このコマンドを実行すると v1.4-lw で指定した軽量タグを作成します。軽量タグは -a、-s、または -m オプションを指定しなくても作成されます。軽量タグでは新しいタグ チェックサムが作成されて、プロジェクトのリポジトリの .git/ ディレクトリにそのチェックサムが保存されます。

リポジトリに保存されたタグを一覧表示するには以下を実行します。

タグの一覧が出力されます。

タグの一覧を絞り込むには、ワイルド カード表現を使って -l を渡します。

上のサンプルでは -l オプションとワイルドカード表現 -rc を使って -rc のプレフィックスが付いたすべてのタグの一覧を返しています。これは通常、リリース候補を特定するために使用されます。

前のタグ付けのサンプルでは暗黙コマンドの操作を、実例を挙げて説明しました。デフォルトでは、git tag は HEAD が参照しているコミット上にタグを作成します。git tag を特定のコミットの ref としても渡せます。この場合、HEAD をデフォルトにする代わりに、渡されたコミットにタグを付けます。古いコミットの一覧を集めるには、git log コマンドを実行します。

git log を実行するとコミットの一覧が出力されます。このサンプルでは一番上のコミット Merge branch 'feature' を新しいタグとして使います。Git に渡すにはコミット SHA ハッシュを参照する必要があります。

上の git tag 呼び出しを実行すると、前の git log サンプルで選択したコミット用に、v1.2 で指定した新しい注釈付きタグが作成されます。

既存のタグと同じ識別子を使ってタグを作成すると、以下のようなエラーが表示されます。

また、既存のタグ識別子を使って以前のコミットにタグを付けようとしても同じエラーが表示されます。

既存のタグを更新する必要がある場合は、-f FORCE オプションを使う必要があります。

上のコマンドを実行すると、15027957951b64cf874c3557a0f3547bd83b3ff6 コミットを v1.4 のタグ識別子にマッピングします。v1.4 タグの既存のコンテンツはすべて上書きされます。

タグの共有はブランチのプッシュと似ています。デフォルトでは、git push でタグはプッシュされません。タグは明示的に git push に渡す必要があります。

複数のタグを同時にプッシュするには --tags オプションを git push コマンドに渡します。別のユーザーがリポジトリをクローンまたはプルすると、新しいタグを受け取ります。

git checkout コマンドを使うと、タグのリポジトリの状態を表示できます。

上のコマンドでは v1.4 タグをチェックアウトしています。これによってリポジトリは detached HEAD 状態になります。つまり、どの変更もタグを更新しないということです。これによって分離した新たなコミットが作成されます。新たに分離したコミットはどのブランチにも属さず、直接到達できるのはコミット SHA ハッシュからだけです。そのため、detached HEAD 状態で変更を加えたときは毎回新しいブランチを作成することが推奨されます。

タグの削除はいたってシンプルな操作です。-d オプションとタグ識別子を git tag に渡すと、指定したタグが削除されます。

このサンプルでは git tag を実行して v1、v2、v3 のタグ一覧を表示しています。その後、git tag -d v1 を実行して v1 タグを削除しています。

まとめると、タグ付けとは Git リポジトリのスナップショットを作成するための追加のメカニズムということになります。タグ付けは従来、ソフトウェア リリースのサイクルに対応するセマンティック バージョン番号識別タグを作成するために使用されて来ました。git tag は、作成、修正、削除など、タグの操作の基本となるコマンドです。タグには注釈付きと軽量の 2 種類があります。注釈付きタグには、タグに関する重要なメタデータを追加で保存できるため、ほとんどのケースに適しています。このドキュメントで取り上げた追加の Git コマンドは git push と git checkout です。これらのコマンドの詳しい使い方については、それぞれのページを参照してください。