【 git tag 】コマンド(基礎編)――タグを一覧表示するLinux基本コマンドTips(393)

本連載は、Linuxのコマンドについて、基本書式からオプション、具体的な実行例までを紹介していきます。今回はGitの「コミット」に対する「タグ」の一覧を表示したり、作成や削除を実行したりする「git tag」コマンドです。

» 2020年05月01日 05時00分 公開
[西村めぐみ@IT]

この記事は会員限定です。会員登録(無料)すると全てご覧いただけます。

「Linux基本コマンドTips」のインデックス

Linux基本コマンドTips一覧

 本連載は、Linuxのコマンドについて、基本書式からオプション、具体的な実行例までを紹介していきます。今回はGitの「コミット」に対する「タグ」の一覧を表示したり、作成や削除を実行したりする「git tag」コマンドです。

git/git tagコマンドとは?

 「git」は「Git」という分散型バージョン管理システム用のコマンドです。Gitは元々Linuxカーネルのソースコードを管理するために作られた「バージョン管理システム」で、現在は多くのソフトウェアやWebサイトのソースコード、ドキュメントの管理などに用いられています。

 ソースコードを管理する際、最新版だけを保存するやり方はうまくいきません。開発中のさまざまなタイミングで状態を管理し、必要に応じて比較、参照したり、元に戻したりできるようにする仕組みが「バージョン管理システム」です。

 Gitでは、テスト版など複数に枝分かれした状態も管理できます。複数のメンバーによる開発を前提としており、開発中の各時点におけるコメントや、コメントへの返信なども管理できるようになっています。

gitのサブコマンドとGitの仕組み

 gitコマンドはほとんどの場合、「サブコマンド」と組み合わせて利用します(本連載ではgitとサブコマンドの組み合わせをコマンドとして紹介します)。

 gitコマンドでは「リポジトリ(repository)」を使ってバージョンを管理します。リポジトリにはソースコードや変更履歴、コメントなどを一括して保管します。リポジトリには、自分のPC上に作る「ローカルリポジトリ」と、「GitHub」などのWebサービス上に作る「リモートリポジトリ」があり、両者を連携させることで複数の開発者による開発を1本にまとめることができます。

 既存のリポジトリ(リモートリポジトリ)にあるソースコードなどを入手したい場合は、まず、「git clone」(連載第381回)でリポジトリを自分の環境に複製します(※1)。リモートリポジトリの内容がバージョンアップされたら「git pull」(連載第382回)コマンドで最新版を取得します。開発に参加するのではなく、単に最新版を取得したいという場合は、「git clone」と「git pull」を利用すればよいでしょう。

※1 特定のファイルだけが欲しい場合、例えばGitHub(github.com)にあるリポジトリであれば「Raw」というボタンで表示されるURLを使い、「wget」コマンドなどを使ってダウンロードできる。この他、プロジェクト全体をダウンロードするためのリンクも用意されている([Clone or download]ボタン→「Download ZIP」)。



 保管場所であるリポジトリに対し、ファイルの編集などを行う場所を「ワークツリー」「ワーキングエリア」「作業ツリー」などと呼びます。「git clone」や「git pull」で取得した最新版のファイルはワークツリーに配置されます。つまり「作業ディレクトリ」です。

 ワークツリーで編集した結果をリポジトリに反映する操作を「コミット」と呼びます。「git add」(連載第384回)コマンドでコミットしたいファイルを「インデックス」あるいは「ステージングエリア」と呼ばれる領域に追加します。インデックスにはファイルの変更箇所などが記録されます。

 インデックスの内容は「git commit」コマンドでローカルリポジトリにコミットされ、「git push」コマンドでローカルリポジトリの内容をリモートリポジトリに反映します。従って、「git add」や「git commit」などを行わなければ、自分の環境で編集した内容がリポジトリに影響を与えることはありません。自由に編集し、テストできます。なお、ワークツリーのファイルを過去の任意のコミット状態に戻すことも可能です。

 Gitには、この他、開発中のソースコードやドキュメントを、「テスト版」「○○版」……のように枝分かれさせたり、それらを合流させたりする機能もあります。枝分かれしたそれぞれのバージョンを「ブランチ」(branch)と呼び、ブランチを合流させることを「マージ」(merge)と呼びます。

 コミットには「タグ」と呼ばれる名前を付けることができます。今回紹介する「git tag」はタグの表示や作成、削除を行うコマンドです。今回はタグの表示について扱います。連載第394回ではタグの作成と削除の方法を紹介します。



コマンドの書式

git [オプション] サブコマンド [サブコマンドごとのオプションや引数]

git tag [オプション] タグ名 [対象]

git tag [-dまたは-vオプション] タグ名

git tag [オプション] [パターン]

※ 「対象」にはファイル名やブランチ、タグ、コミットのハッシュ値などが指定可能。[ ]は省略可能な引数を示しています。




gitの主なオプション

短いオプション 長いオプション 意味
-C パス カレントディレクトリではなく指定したディレクトリで実行したものとする
--bare リポジトリを「bareリポジトリ」(ワーキングツリーが存在しない、管理だけを目的としたリポジトリ)として扱う
-c 設定=値 設定値を指定する(設定は「git config」で確認可能)
-p --paginate 全ての出力を「less」コマンドまたは環境変数PAGERで指定されたコマンドで表示する
-P --no-pager 「less」コマンドで表示しない(「-p」の指定を打ち消す)
--exec-path=パス gitの実行ファイルのパスを指定する(「--exec-path」のみの場合、実行ファイルのパスを表示する)
--html-path gitのHTML形式のドキュメントがインストールされたパスを表示する
--man-path gitのmanファイルのパスを表示する
--info-path gitのinfoファイルのパスを表示する

gitのサブコマンド

コマンド 実行内容
clone リポジトリのクローンを作成する
init リポジトリを新規作成する、または既存のリポジトリを初期化する
remote リモートリポジトリを関連付けする
fetch リモートリポジトリの内容を取得する
pull リモートリポジトリの内容を取得し、現在のブランチに取り込む(「fetch」と「merge」を行う)
push ローカルリポジトリの変更内容をリモートリポジトリに送信する
add ファイルをインデックスに追加する(コミットの対象にする)
rm ファイルをインデックスから削除する
mv ファイルやディレクトリの名前を変更する
reset ファイルをインデックスから削除し、特定のコミットの状態まで戻す
status ワークツリーにあるファイルの状態を表示する
show ファイルの内容やコミットの差分などを表示する
diff コミット同士やコミットとワークツリーの内容を比較する
commit インデックスに追加した変更をリポジトリに記録する
tag コミットにタグを付ける、削除する、一覧表示する
log コミット時のログを表示する
grep リポジトリで管理されているファイルをパターン検索する
branch ブランチを作成、削除、一覧表示する
checkout ワークツリーを異なるブランチに切り替える
merge 他のブランチやコミットの内容を現在のブランチに取り込む
rebase コミットを再適用する(ブランチの分岐点を変更したり、コミットの順番を入れ替えたりできる)
config 現在の設定を取得、変更する

git tagの主なオプション(タグの作成と削除、署名の確認)

短いオプション 長いオプション 意味
-f --force 同じ名前のタグがあった場合は上書きする
-a --annotate 注釈付きタグを生成する(※2)
-s --sign GPG(GNU Privacy Guard)署名付きのタグを生成する(※2、※3)
-u キーID --local-user=キーID 指定したキーIDを使用してGPG署名付きのタグを生成する(※2)
-m 注釈 --message=注釈 タグに注釈を付ける(「-a」を指定した扱いになる)
-F ファイル --file=ファイル タグの注釈をファイルから読み出す(「-a」を指定した扱いになる)
-e --edit 「-m」や「-F」で指定した注釈を編集する
-d --delete 指定したタグを削除する
-v --verify 指定したタグのGPG署名を確認する

※2 「-a」「-s」「-u」を指定した場合は注釈(メッセージ)の入力が必要になる。「-m」「-F」で注釈を指定していない場合はエディタ(vi)が起動する
※3 事前に「git config --global user.signingkey キーID」で公開鍵を登録しておく。キーIDは「gpg --list-keys」で確認できる。キーがない場合は「gpg --gen-key」で作成する。



git tagの主なオプション(タグの表示)

短いオプション 長いオプション 意味
-n行数 注釈またはコミットメッセージを表示する行数を指定する(「-n」または「-n1」で1行、本文を参照
-l --list タグを一覧表示する(「--list 'v-*'」のようなパターン指定が可能)
--sort=キー タグを一覧表示する際の表示順を指定する(本文を参照、※4)
-i --ignore-case 並べ替えや絞り込みでアルファベットの大小文字を区別しない
--column タグを1行1列ではなくマルチカラム表示にする
--no-column タグをマルチカラムではなく1行1列で表示する
--contains コミット HEADから指定したコミットまでの間に存在するタグを表示する(コミットを指定しなかった場合はHEADが対象になる)
--no-contains コミット HEADから指定したコミットまでの間に含まれないタグを表示する(コミットを指定しなかった場合はHEADが対象になる)
--merged マージしたときのコミットに付いているタグを表示する
--no-merged マージしたとき以外のコミットに付いているタグを表示する
--points-at 対象 指定した対象(コミットなど)に付いているタグを表示する

※4 使用できるキーは「man git for-each-ref」の「FIELD NAMES」を見て確認できる。





タグを一覧表示する

 gitのコミットには、「ハッシュ値」と呼ばれる固有の値が付いており、このハッシュ値でコミットを特定できます。コミットに「タグ」と呼ばれる別名を付けておくこともできます。

 例えば、コミットの情報を表示する「git show」コマンドでは、「git show タグ名」(連載第389回)のように、タグを使ってコミットを指定できます。

 現在のブランチでどのようなタグが使われているかを一覧表示するには、「git tag」または「git tag -l」(「--list」オプション)を使います。タグ1件を1行で表示しますが、マルチカラムで表示したい場合は「git tag --column」のようにオプションを使います。

コマンド実行例

git tag

(現在のブランチで使用されているタグを一覧表示する)

git tag --column

(現在のブランチで使用されているタグをマルチカラムで一覧表示する)


 以下のコマンドの実行例では、前回に引き続き「progit2-ja」を使用しています。「git clone https://github.com/progit/progit2-ja」で自分の環境に複製を作り(連載第381回)、ワークツリーであるprogit2-jaディレクトリの中で実行しています。

 画面1では、確認のため「git tag」に先立ち「git log --oneline -10」で直近10件のコミットを一覧表示しています(連載第386回)。

画面1 画面1 全てのタグを一覧表示したところ

 タグが付いているコミットでは、git logの実行時、ハッシュ値の後に「(tag: タグ名)」といった表示が付きます。画面1を見ると、直近10回分のコミットでは、「2.1.3」「2.1.2」「2.1.1」というタグがあることが分かります。なお、途中の赤字で表示されている「origin/fix-104」は、そのコミットで新たに「fix-104」というブランチに枝分かれてしていることを示しています(※5)。

※5 originはリポジトリの別名で、通常、デフォルトのリポジトリには「origin」という名前が付いている。同様に、デフォルトのブランチには「master」という名前がある。





タグをメッセージ付きで一覧表示する

 「git tag -n」で、タグの注釈(タグを作成した際に付けたメッセージ、連載第394回)を一覧表示します。なお、注釈がない場合はコミット時のメッセージの1行目とともに表示します。

 メッセージを複数行にわたって表示したい場合は「git tag -n3」のように「-n」オプションに続けて行数を指定します。

コマンド実行例

git tag -n

(タグをメッセージ付きで一覧表示する)

git tag -n3

(メッセージを最大3行分付けて一覧表示する)


 画面2では、コマンドの実行結果について、「head」コマンドを使って冒頭部分だけを表示しています。

画面2 画面2 タグをメッセージ付きで一覧表示したところ


タグの並び順を指定する

 タグを表示した場合、「辞書順」でソートされます。従って、タグ名に数字が使われている場合、例えば「1」「9」「10」は「1」「10」「9」と並びます。なるべく数値の順番に並ぶようにしたい場合は「--sort v:refname」オプションを指定します。逆順にしたい場合は「-」を付けて「--sort -v:refname」を付けます。

 タグ付けされた日付順にしたい場合は「--sort=taggerdate」を使います(画面3)。新しい順(逆順)にしたい場合は「-」を付けて「--sort=-taggerdate」とします(※6)。

※6 「--sort」オプションで指定できるキーは「man git for-each-ref」の「FIELD NAMES」を見て確認できる。



コマンド実行例

git tag --sort v:refname

(タグの数字を辞書順《初期設定は「--sort refname」》ではなく値の順にソートして表示する)

git tag --sort=taggerdate

(タグ付けされた日付順《古い順》でソートする)

git tag --sort=-taggerdate

(タグ付けされた日付順《新しい順》でソートする)

git tag --sort=taggerdate -n

(タグを新しい順に、メッセージ付きで表示する)


画面3 画面3 タグの並び順を指定したところ タグ付けされた日付順に表示した

 タグが付いているコミットを一覧表示する際、「git tag」を使う以外の方法もあります。「git log --oneline」の結果を「tag:」で絞り込むと新しい順(※7)に一覧表示できます(画面4)。「git log --oneline」をページャー以外で表示すると「書式なし」となり「tag:」などの表示もなくなってしまうため「--decorate」オプションも指定しています。

※7 逆順(古い順)に並べたい場合はgit logの「--reverse」オプションを使用する。



画面4 画面4 タグが付いているコミットを新しい順に一覧表示したところ git logコマンドを使った


パターンを指定してタグを表示する

 「git tag -l パターン」で、表示対象のタグを指定できます。例えば、「git tag -l "2.0*"」では、「2.0」から始まるタグを一覧表示します(画面5)。

コマンド実行例

git tag -l パターン

(指定したパターンに当てはまるタグを一覧表示する)

git tag -l "2.0*"

(「2.0」から始まるタグを一覧表示する)


画面5 画面5 パターンを指定してタグを表示したところ

 なお、「-l」(--list)オプションで「"2.0*"」のようにパターンを指定する場合、「-l」を省略して「git tag "2.0*"」のように実行することもできます。

 しかし、「-l」を省略すると意図したのとは違う動作になる場合があります。例えば「git tag -l "2.0.0"」のような場合、「-l」を付けた場合は「『2.0.0』というタグを表示」を実行しますが、「-l」を付けずに「git tag "2.0.0"」とすると、「現在のコミットに『2.0.0』というタグを付ける」という意味になります(連載第394回)。表示対象を指定したい場合は、常に「-l」を付けて操作を明示する習慣にした方がよいでしょう。



範囲を指定してタグを表示する

 「git tag --contain タグ名」または「git tag --no-contain タグ名」で、表示するタグの範囲を指定できます(画面6)。

 「--contain タグ名」と指定した場合、先頭のコミット(HEADコミット)から指定したタグ名までの間にあるタグを表示します。従って、「git tag --contain 2.1.1」のようにすると、「2.1.1」以降のコミットに付いているタグを表示します。

 「--no-contain タグ名」では、指定したタグよりも古いコミットに付いたタグを表示します。どちらの場合も、タグ名を省略した場合は先頭のコミットを対象とします。

コマンド実行例

git tag --contain タグ名

(先頭のコミットから指定したタグまでのタグを表示する)

git tag --contain 2.1.1

(「2.1.1」以降のコミットに付いているタグを表示する)

git tag --no-contain タグ名

(指定したタグが付いているコミットより古いコミットのタグを表示する)

git tag --no-contain 2.0.0

(「2.0.0」より古いタグを表示する)


画面6 画面6 範囲を指定してタグを表示したところ


筆者紹介

西村 めぐみ(にしむら めぐみ)

元々はDOSユーザー。ソフトハウスに勤務し生産管理のパッケージソフトウェアの開発およびサポート業務を担当、その後ライターになる。著書に『図解でわかるLinux』『らぶらぶLinuxシリーズ』『[新版 zsh&bash対応] macOSコマンド入門』『Accessではじめるデータベース超入門[改訂2版]』など。地方自治体の在宅就業支援事業にてMicrosoft Officeの教材作成およびeラーニング指導を担当。会社等の"PCヘルパー"やピンポイント研修なども行っている。


Copyright © ITmedia, Inc. All Rights Reserved.

スポンサーからのお知らせPR

注目のテーマ

Microsoft & Windows最前線2025
AI for エンジニアリング
ローコード/ノーコード セントラル by @IT - ITエンジニアがビジネスの中心で活躍する組織へ
Cloud Native Central by @IT - スケーラブルな能力を組織に
システム開発ノウハウ 【発注ナビ】PR
あなたにおすすめの記事PR

RSSについて

アイティメディアIDについて

メールマガジン登録

@ITのメールマガジンは、 もちろん、すべて無料です。ぜひメールマガジンをご購読ください。