Git Ready
リリースにタグを付ける - git tag の使い方・オプション・サンプル

リリースにタグを付ける- git tag

コミットにタグ(tag)を付けます(リリースバージョンなど)。

概念図

git tag diagram

構文

bash
git tag [options] [<tagname>]

使用例

タグを作成

bash
git tag v1.0.0

注釈付きタグを作成

bash
git tag -a v1.0.0 -m "Release 1.0"

軽量タグと注釈付きタグ

タグには2種類あり、リリース用途では 注釈付きタグ が推奨されます。

  • 軽量タグ(lightweight)

    git tag v1.0.0 のようにメッセージなしで作成するタグです。単なるコミットへのポインタで、作成者や日付などのメタデータは記録されません。一時的なマーカー用途に向きます。

  • 注釈付きタグ(annotated)

    git tag -a v1.0.0 -m "..." で作成します。タグの作成者、日付、メッセージが記録され、独立したオブジェクトとして保存されます。リリース管理やチーム開発ではこちらを使うのが定石です。

注意点

  • タグは自動でプッシュされない

    タグはデフォルトでは git push でリモートに送信されません。明示的に git push origin <タグ名> または git push origin --tags を実行する必要があります。忘れがちなので注意しましょう。

  • プッシュ済みタグの変更は両方必要

    既にプッシュ済みのタグを削除・変更する場合は、ローカルとリモートの両方で操作が必要です(git tag -dgit push origin --delete)。

  • 命名規則を揃える

    タグ名にはセマンティックバージョニング(v1.0.0 のような形式)を使うのが一般的で、チーム内で命名規則を統一しておくと管理が楽になります。

関連コマンド