Gitタグ

タグ付けは、Gitリポジトリの履歴内の特定のポイントを追跡するために使用される機能です。

時間の経過とともに、Gitリポジトリを操作するときに、コードベースに多数の変更を加えることになります。 Gitでは、コミットは個々の変更を追跡するために使用されます。

ただし、バージョンなど、リポジトリの履歴のポイントをキャプチャする場合は、Gitタグ付け機能を使用することをお勧めします。

このチュートリアルでは、例を使用して、タグ付けの基本と、gittagコマンドを使用してGitリポジトリ内のタグを操作する方法について説明します。このチュートリアルを読み終えると、Gitでタグを操作するエキスパートになります。

Gitのタグ付け

タグは、Gitリポジトリの履歴の特定の部分を指す参照（参照）です。

タグは通常、開発者がレポの履歴の特定のポイントをキャプチャしてバージョンリリースを作成するために使用されます。たとえば、開発者がプロ​​ジェクトの新しいバージョンを起動する準備ができたら、プロジェクトのタグを作成できます。

本質的に、タグは変更されないブランチです。タグを作成すると、タグの履歴にコミットが追加されなくなります。代わりに、タグは、タグが追加されたときにリポジトリがどのように表示されたかのスナップショットを保存します。

Gitでサポートされているタグには2つの異なるタイプがあります。これらは：

参加者の81％は、ブートキャンプに参加した後、自分たちの技術的な仕事の見通しについてより自信を持っていると述べました。今日のブートキャンプにマッチしましょう。

平均的なブートキャンプの卒業生は、ブートキャンプの開始から最初の仕事を見つけるまで、キャリアの移行に6か月も費やしませんでした。

• 注釈付きタグ。これらは、Gitデータベースに完全なオブジェクトとして保存されるタグです。
• 軽量タグ。これらは、名前であり、コミットへのポインタであるタグです。

これで、Gitタグ付けの基本について説明し、Gitでタグを操作する方法を探ります。

タグを作成する

Gitでタグの操作を開始する前に、タグを作成する必要があります。 Gitでタグを作成するための構文は次のとおりです。

git tag <name>

「name」パラメーターは、作成するタグの名前を参照します。タグ付けは通常、プロジェクトのバージョンを追跡するために使用されるため、タグには「v1.2」や「beta-v0.9」などの名前を使用することをお勧めします。

作成したタグは、リポジトリで現在行っているコミットに適用されます。

注釈付きタグ

注釈付きタグは、Gitデータベースに完全なオブジェクトを格納するタグです。注釈付きタグを作成すると、タグを作成した人の名前、メールアドレス、タグが作成された日付などのメタデータが保存されます。

さらに、注釈付きのタグは、タグのメッセージとともに保存されます。一般的に言えば、注釈付きタグによって保存されたメタデータは、将来的に多くの用途を持つ可能性があるため、注釈付きタグは軽量タグよりも優先されます。

たとえば、時間の経過とともにバージョン管理の責任者を追跡する場合は、注釈付きタグによって保存されたメタデータにアクセスする必要があります。

Gitで注釈付きタグを作成するための構文は次のとおりです。

git tag -a <name>

-aフラグは、注釈付きタグを作成するようにGitに指示するために使用されます。 「name」パラメーターは、作成するタグの名前です。

このコマンドを実行すると、system-defaultテキストエディタが開き、注釈付きタグのメッセージを挿入するように求められます。これは、前に説明したように、注釈付きタグがメッセージとともに保存されるために発生します。

または、タグを直接作成するメッセージを指定することもできます。次のコードを使用してこれを行うことができます：

git tag -a <name> -m <message>

-mタグは、注釈付きタグにメッセージを追加するために使用されます。 「バージョン1.9」というメッセージを含むv1.9というタグを作成したいとします。このコードを使用してこれを行うことができます：

git tag -a v1.9 -m "version 1.9"

このコマンドを実行すると、v1.9というタグが作成され、「バージョン1.9」というメッセージが表示されます。

このコマンドを実行すると、メッセージなしでgitタグを使用するよりも便利です。これにより、コミットメッセージを指定しない場合に表示されるデフォルトのテキストエディタにメッセージを入力しなくても、コミットメッセージを直接指定できるためです。

軽量タグ

軽量タグを作成するには、前に説明した標準のgitタグ構文を使用する必要があります。 「v1.9.1」という軽量のタグを作成するとします。次のコードを使用してこれを行うことができます：

git tag v1.9.1

このコマンドは、v1.9.1と呼ばれる軽量タグを作成します。軽量タグを作成する場合、タグメッセージを指定する必要はありません。代わりに、新しいタグチェックサムが作成され、プロジェクトの.gitフォルダーに保存されます。

プロジェクトのタグを一覧表示する

大規模なプロジェクトで作業している場合、リポジトリのタグ付きバージョンがいくつかある場合があります。プロジェクトに保存されているタグのリストを取得するには、次のコマンドを使用できます。

git tag

このコマンドは、タグのリストを返します。このコマンドの出力例は次のとおりです。

v1.9.1
v1.9.0
v1.8.11
v1.8.10
v1.8.9
...

さらに、-lフラグを使用して、プロジェクトで使用されるタグを除外できます。たとえば、「v1.8」で始まるすべてのタグのリストを取得する場合は、次のコードを使用できます。

git tag -l v1.8*

このコマンドでは、-lフラグを指定し、その後に「v1.8*」を指定しました。これは、v1.8で始まるすべてのタグのリストを取得するようにGitに指示します。アスタリスク（*）は、返されるタグに「v1.8」以降の任意の文字を含めることができることを示します。

このコマンドの出力例は次のとおりです。

v1.8.11
v1.8.10
v1.8.9
v1.8.8
...

ご覧のとおり、返されるタグはすべて「v1.8」で始まります。

タグをチェックアウト

git checkoutコマンドを使用して、特定のタグを使用したコミットでリポジトリの状態を表示できます。たとえば、v1.1のときにリポジトリを表示したいとします。次のコードを使用してこれを行うことができます：

git checkout v1.1

このコマンドは、リポジトリを「切り離されたHEAD」状態に移行します。つまり、変更を加えても、タグ付けされたバージョンのリポジトリは更新されません。代わりに、どのブランチにも関連付けられない新しいデタッチされたコミットが作成されます。

このコマンドを実行すると、v1.1のタグが付けられたコミットでコードベースがどのように表示されるかを確認できます。

古いコミットにタグを付ける

前の例では、git tag関数を使用して、作業しているgitの現在のバージョンにタグを追加する方法について説明しました。これは、デフォルトでは、gitタグがHEADコミット（現在表示しているコミット）のタグを作成するためです。

ただし、gittagコマンドを使用して古いコミットにタグを付けることもできます。これを行うには、タグを追加する特定のコミットの参照を指定します。

リポジトリ内の最後のコミットにタグを追加するとします。そのためには、最初にgitlogを実行する必要があります。これにより、最近のコミットのリストを取得できます。動作中のgitlogコマンドの例を次に示します（–pretty =onelineフラグを使用すると、コミットを簡単に確認できます）：

git log --pretty=oneline

コマンドは次を返します：

8cd29ae5d04abbdbd856d2c2f55f2b82133903e8 Push new logging feature
2911aae73ed1dd372bcdf8f520b174c3817c818b Initialize logging feature
9646aa785211f3069ce01177da98e23b7890d859 Fix issue #342

ここで、「Fix issue＃342」コミットにタグを追加したいとします。このタグを「v1.3」と呼びたい。次のコードを使用してこのタグを追加できます：

git tag -a v1.3 9646aa785211f3069ce01177da98e23b7890d859

このコマンドは、コードで参照したコミットにタグ1.3を追加します。この場合、「Fix issue＃342」というメッセージを使用して、コミットのSHAハッシュを指定しました。

古いタグを置き換える

各コミットは1つのタグのみを持つことができます。コミットに関連付けられたタグを別のタグに置き換えることにした場合は、gitタグを使用して置き換えることができます。ただし、-f（force）オプションを指定する必要があります。これにより、既存のタグが上書きされます。

前の例で説明したコミットにタグ「v1.3.1」を追加したいとします。 -fフラグを使用せずにこれを実行しようとすると、エラーメッセージが表示されます。以前のコミットにタグ「v1.3.1」を追加するには、次のコマンドを使用できます。

git tag -a -f v1.3.1 9646aa785211f3069ce01177da98e23b7890d859

このコマンドは、タグ「v1.3.1」をコミットに追加し、以前に持っていた「v1.3」タグをオーバーライドします。

タグを削除する

gitを使用してタグを削除するには、-dフラグを使用できます。リポジトリからタグ「v1.3」を削除したいとします。このコードを使用してこれを行うことができます：

git tag -d v1.3
git tag

コードは次のようになります：

v1.4
v1.2
v1.1

最初のコマンドは、リポジトリからタグv1.3を削除します。 2番目のコマンドは、タグのリストを返します。ご覧のとおり、タグのリストを取得すると、タグv1.3がありません。これは、-dフラグを使用してタグを削除したためです。

結論

タグ付けは、Gitリポジトリのさまざまなバージョンを追跡するために開発者が使用するGitの重要な機能です。タグは、開発者が表示している現在のコミット、またはリポジトリ内の既存のコミットに追加できます。

このチュートリアルでは、例を挙げて、Gitでのタグ付けの基本とGitタグコマンドの使用方法について説明しました。これで、プロの開発者のようにgittagコマンドを使い始める準備ができました。