リリースタグとは？

リリースタグは Git タグで、通常はバージョン番号で、特定のリリースとして出荷された正確なコミットをマークします。

リリースタグはコミットを名前付きのバージョンに変えます。チームがあるコミットを出荷準備完了と判断したとき、v2.1.0 のような名前でタグを付けます。そのタグはそのリリースの永続的な参照となり、多くのパイプラインではビルドと公開のシグナルにもなります。

タグをリリースタグにするもの

技術的にはリリースタグは通常のタグです。それをリリースタグにするのは慣習と意図です。すべてのチェックを通過し、ユーザー向けを意図したコミットに名前を付けます。リリースが作者、日付、メッセージを持つように、注釈付きで多くは署名されたタグが好まれます。

セマンティックバージョニング

ほとんどのリリースタグは major.minor.patch 方式に従います。数字は変更の性質を一目で伝えます。

A semantic-version release tag

git tag -a v2.1.0 -m "Add export API; fix pagination"
git push origin v2.1.0

なぜリリースタグが重要か

リリースタグは、人間にも機械にも、出荷されたバージョンへの明確なハンドルを与えます。サポートはユーザーが実行している正確なビルドを再現でき、ロールバックは以前のタグを自信を持って対象にできます。タグは「バージョン 2.1.0」が何を意味するかの契約です。

CI/CD におけるリリースタグ

リリースパイプラインは push されたバージョンタグで発火することが一般的です。workflow はタグ付けされたコミットから artifact をビルドし、最終チェックを実行し、レジストリに公開し、リリースノートをドラフトします。タグはイミュータブルなので、公開された artifact は正確で再現可能なソース状態に紐づきます。

リリースタグ付けのコツ

CI を通過し本当に出荷可能なコミットだけにタグを付けます。
予測可能なバージョン番号のためにセマンティックバージョニングを採用します。
タグ push イベントからリリースビルドを自動化します。
来歴が重要な場合はリリースタグに署名します。

重要なポイント

リリースタグはバージョンとして出荷された正確なコミットをマークします。
セマンティックバージョニングはバージョン番号を意味あるものにします。
push されたリリースタグは一般的にビルド・公開パイプラインをトリガーします。