Github default branch를 master → main으로 변경하는 법

IT업계에서 용어가 변경되는 경우가 생기고 있다. 

"Black Lives Matter"시위와 관련이 있는데, 과거의 흑인과 백인의 인종차별적인 단어들이 쓰이고 있다고 하여, IT업계에서 이와 같은 용어들이 변경되고 있다.

 

대표적인 예로 whitelist와 blacklist가 각각 allowlist / denylist로 변경되었다.

이와 같이 github도 많은 프로그래머들의 요청으로, master가 main으로 변경하는 것을 결정하였다.

 

 

• 기존의 master를 사용하는 도중 main으로 변경하는 법

 

#원격으로 repository를 연결한다.
git remote add origin [URL]

 

 

#local branch master를 main으로 변경한다.
git branch -m master main

 

 

#변경한 main branch를 repository에 push한다.
git push -u origin main

# -u 옵션은 최초에 저장소명과 branch명을 입력하고 이후에는 생략 가능하게 하는 옵션이다.
# ignoring broken ref refs/remotes/origin/HEAD 오류가 발생한다면 이 단계를 다시 확인한다.

 

 

#현재의 HEAD를 main을 가리키도록 설정한다.
git symbolic-ref refs/remotes/origin/HEAD refs/remotes/origin/main

 

 

#변경하고자 하는 repository의 setting에서 default branch를 main으로 변경한다.
https://docs.github.com/en/github/administering-a-repository/setting-the-default-branch

 

 

#기존의 master branch를 삭제한다.
git push origin --delete master

 

 

• 단계에 따른 변화(이미지 설명)

 

 

 

 

 

 

#출처 및 참고

stevenmortimer.com/5-steps-to-change-github-default-branch-from-master-to-main/#all-commands

docs.github.com/en/github/administering-a-repository/setting-the-default-branch