概要

Master, Slave という用語の廃止が進むにつれて、
Gitlab のデフォルトブランチ名も、master から main に変更されました。

この記事では、既存プロジェクトのデフォルトブランチ名を main に変更する手順を記載します。

対象とする読者

※既存のプロジェクトのデフォルトブランチを master とした場合の例です。
※特に明示しない限り、操作は CUI にて実施します。

既存プロジェクトの master ブランチを checkout => pull で最新化する。

git checkout master
git pull

master ブランチを main にリネームする。

git branch -m master main

git branch

※表示結果
* main

main ブランチを push する。

git push origin main

Default ブランチは、git pull した際に最初に取得されるブランチです。
ブランチを明示的に指定しない場合の、Merge Request や Commit の宛先でもあります。

Gitlab UI のサイドバーの Settings => Repository で、Repository 設定を開く。

Default branch の Expand を開く。

Protected branches に追加されたブランチは、
削除ができなくなり、merge や pull ができるユーザを制限することもできます。

Gitlab UI のサイドバーの Settings => Repository で、Repository 設定を開く。

Protected branches の Expand を開く。

以下の項目を入力し、Protect を押して追加する。

master ブランチを Protected から外す。

git push origin --delete master

Gitlab UI にて、Merge Request（以降MR）の向け先を１つずつ main に変更する。

これを、MR の数だけ繰り返す。

終わり