[ Git ] remote branch master -> main 이름 변경하기

🔒 Problem

Github 나 Gitlab 의 경우 브랜치 이름을 웹 사이트에서 직접 변경할 수 있지만, 그렇지 못한 경우 브랜치 이름을 로컬 저장소에서 바꾸고 원격 저장소에 푸쉬하는 방법에 대해 다뤄보자.

기존 브랜치 이름 : master
신규 브랜치 이름 : main

🔓 Solve

1. 원격 저장소 내용을 로컬 저장소에 clone 받는다.
2. 로컬저장소에서 main 브랜치를 생성하면서 checkout 한다.

$ git checkout -b main

3. 원격 저장소에 새로운 main 브랜치를 push 한다.

$ git push -u origin main

✒️ 2023.01.16 수정
아래에 있는 4. 명령어를 수행하기 위해서는 Github에 접속하여 default 브랜치 이름을 바꿔주어야 정상적으로 원격 저장소에서 master 브랜치를 삭제할 수 있다.

4. 원격 저장소에서 기존 master 브랜치를 delete 한다.

$ git push origin --delete master

5. 원격 저장소의 기본(default) 브랜치를 main 으로 변경한다.

$ git remote set-head origin -a

6. 정상적으로 변경되었는지 확인한다.

$ git symbolic-ref refs/remotes/origin/HEAD
# refs/remotes/origin/main 값이 나타나면 ok.