概要

GitLab上でタグとリリースを管理している際に、手違いでタグのみを消してしまった場合の対処法についての記事です。

環境

GitLabには、リリース時に利用できる以下の2機能が用意されています。

リリース機能はタグと合わせて利用することが前提なので、リリース単体を削除する方法はなくタグを削除する際に併せて削除されます。
そのため、普通に画面上から操作していれば特に問題はありません。

GitLab上でタグのみが削除され、リリースが編集・削除できなくなりました。

私は普段VS CodeのGit Graphという拡張機能を利用してタグの作成・削除を行なっています。
そのGit Graphの機能にタグの削除(オプションでリモートも併せて削除する)があるのですが、その機能でGitLab上にリリースが残ったままタグのみを削除してしまいました。

画面上の操作ではリリースはタグに紐づいて削除されるのですが、今回はこの機能でタグのみを削除してしまった結果編集・削除できないリリースのみが残っていました。

※以下画像は編集した際の画面

この事象の解決策はわかってしまえば簡単で、同じコミットに同じタグ名をつけ、再度pushしてあげることで削除したものと同じタグが作成され解決します。

GitLabの画面上では以下の画像の通りタグ画面にリリースのリリースノートが表示され、事前に作成したリリースと再度pushしたタグが自動で紐づいています。

以上の方法で、タグ画面上からタグを削除しリリースも併せて削除できるようになります。

利用しているGitLabのバージョンを調べる際に、以下の記事が参考になりました。