■ はじめに
リリースが近づいてきて、リポジトリにタグ付けする機会があったので、 git の タグに関連することを纏める
目次
【１】タグ 【２】タグに関するコマンド 【３】Github でのタグに関するあれこれ 【４】クライアントソフト でのタグに関するあれこれ
【１】タグ
* コミットに例えばバージョン番号など 管理しやすくなるように名前（タグ付け）をつける機能
タグの種類
１）軽量タグ (lightweight) ... 名前を付けられる ２）注釈付きタグ (annotated) ... 名前/コメント/署名を付けられる
【２】タグに関するコマンド
１）タグ一覧表示：git tag ２）タグ作成：git tag [タグ名] ３）リモートブランチへの反映：git push origin [タグ名] ４）タグの削除：git tag -d [タグ名] ５）タグのリネーム：git tag [新タグ名] [旧タグ名] ６）git show [タグ名]
https://qiita.com/chihiro/items/cba40015b1aa2c73b78a
１）タグ一覧表示
* 「git tag」を使う
コマンド例
git tag # "v1系"で絞ってみたい場合 git tag -l "v1.*"
２）タグ作成
* 直近のコミットに対して、タグ付けできる * コミットIDに対して、タグ付けもできる
構文
git tag [タグ名] => ex git tag v1.0 git tag [タグ名] [コミットID] => ex git tag v1.1 94eafa78191cc
コマンド例
# 軽量タグ (lightweight) # git tag [タグ名] git tag v0.1.0 # 注釈付きタグ (annotated) # git tag -a [タグ] -m 'タグのコメント' git tag -a v1.0.0 -m 'This is my first tag' # 後からタグ付けする場合 # コミットIDを調べる git log --since=2020-06-20 --until=2020-06-21 # git tag -a タグ -m 'コメント' コミットID git tag -a v0.2.0 -m 'I forgot it...' 9dscs02
３）リモートブランチへの反映
* タグは作成しただけではリモートには反映されないので、 pushする必要がある
コマンド例
# git push origin タグ名 git push origin v1.0.0
４）タグの削除
コマンド例
# git tag -d [タグ名] git tag -d v1.0.0
５）タグのリネーム
* 1つのコマンドではできないので、以下の2コマンドで行う git tag [新タグ名] [旧タグ名] git tag -d [旧タグ名]
コマンド例
# git tag [新タグ名] [旧タグ名] git tag new-tag old-tag # 確認 git tag old-tag new-tag ← 増えた。これを消す必要がある # 古いタグを削除 git tag -d old-tag
６）タグ確認
* タグの内容を確認
構文
git show [タグ名]
【３】Github での タグに関するあれこれ
１）Github 上でのタグ付け ２）Release機能
１）Github 上でのタグ付け
* タグ付けはできない。 * ただし、GitHub Desktopだと対応しているっぽい。
https://github.blog/jp/2020-05-19-create-and-push-tags-in-the-latest-github-desktop-2-5-release/
* 表示はできる。 => タグ表示に関しては、メイン画面から[Releases]で表示される => 詳細は、以下のサイトを参照。
２）Release機能
* リポジトリのタグに説明や添付ファイルを付けて公開できるページ
https://howpon.com/7676
https://qiita.com/tommy_aka_jps/items/5b39e4b27364c759aa53
【４】クライアントソフト でのタグに関するあれこれ
SourceTree
１）タグ付けする ２）タグをPushする
１）タグ付けする
https://pasomaki.com/sourcetree-create-tag/
[1] タグを付けたいコミットを選択した上で、画面上部にある[タグ]イコンを選択 [2] タグ画面でタグ名を入力して「タグを追加」ボタンをクリックする
２）タグをPushする
https://pasomaki.com/sourcetree-tag-push/
* Pushしたいタグを右クリック-[プッシュ先]-[origin]を選択する
その他参考になりそうなサイト
https://nelog.jp/sourcetree-local-repository-branch-tag
https://ics.media/entry/1365/
参考文献
https://backlog.com/ja/git-tutorial/stepup/17/
https://qiita.com/growsic/items/ed67e03fda5ab7ef9d08
https://qiita.com/k-penguin-sato/items/c62b47dd79f144c68dad
関連記事
Git ～ 入門編 ～
https://dk521123.hatenablog.com/entry/2018/06/29/104028
Git ～ 基本編 / ブランチ ～
https://dk521123.hatenablog.com/entry/2018/06/30/135023
ブランチモデル ～ GitHub Flow / Git-flow etc ～
https://dk521123.hatenablog.com/entry/2019/09/29/121256
Git クライアントソフト
https://dk521123.hatenablog.com/entry/2019/09/27/153937
