브랜치 이름 변경에 대한 설명
리포지토리에서 GitHub.com 브랜치의 이름을 변경할 수 있습니다. 분기에 대한 자세한 내용은 브랜치 정보을(를) 참조하세요.
분기의 이름을 바꾸면 이전 분기 이름이 포함된 모든 URL이 이름이 바뀐 분기에 해당하는 URL로 자동으로 리디렉션됩니다. 브랜치 보호 정책도 업데이트되며, 오픈 풀 리퀘스트(포크 포함)와 초안 릴리스의 기준 브랜치도 업데이트됩니다. 이름이 바뀐 분기가 열린 끌어오기 요청의 헤드 분기인 경우, 이 끌어오기 요청은 종료됩니다.
리포지토리의 기본 분기 이름이 바뀐 GitHub 경우 리포지토리의 홈페이지에 대한 지침을 제공하여 기여자에게 로컬 Git 환경을 업데이트하도록 지시합니다.
파일 URL은 자동으로 리디렉션되지만 원시 파일 URL은 리디렉션되지 않습니다. 사용자가 이전 분기 이름에 대해 git pull을(를) 수행할 경우, GitHub는 또한 어떤 리디렉션도 수행하지 않습니다.
GitHub Actions 워크플로는 이름 변경을 따라가지 않으므로 리포지토리에서 작업을 게시할 경우, `@{old-branch-name}`와 함께 해당 작업을 사용하는 모든 사용자의 기능이 중단될 수 있습니다. 기존 콘텐츠가 포함된 새 브랜치를 추가하고, 브랜치 이름이 닫기임을 보고하며, 사용자가 새 브랜치 이름으로 이동하도록 권장하는 추가 커밋을 고려해 보세요.
누가 분기 이름을 바꿀 수 있나요?
대부분의 분기는 리포지토리에 대한 쓰기 권한이 있는 모든 사용자가 이름을 바꿀 수 있습니다.
일부 분기는 리포지토리 관리자(리포지토리의 기본 분기) 및 분기 보호 또는 리포지토리 수준 분기 규칙 집합이 적용되는 분기만 이름을 바꿀 수 있습니다.
조직 수준 또는 엔터프라이즈 수준 규칙 집합이 리포지토리의 분기를 대상으로 하는 경우 일반적으로 해당 분기의 이름을 변경하려면 조직 또는 엔터프라이즈 관리자가 필요합니다.
그러나 조직 및 엔터프라이즈 소유자는 새 분기 이름이 여전히 현재 이름과 동일한 규칙의 적용을 받는 경우 리포지토리 관리자가 이러한 규칙 집합에서 다루는 분기의 이름을 바꾸도록 허용할 수 있습니다. 기본 분기를 변경하려면 규칙 집합이 실행 중인 경우에도 조직 또는 엔터프라이즈 관리자가 필요합니다.
자세한 내용은 리포지토리 관리자가 조직 규칙 집합을 사용하여 분기 이름을 바꿀 수 있도록 허용 및 엔터프라이즈에서 리포지토리 관리 정책 적용을(를) 참조하세요.
리포지토리 관리자는 적절한 권한이 있는 경우에만 분기를 만들고 삭제할 수 있습니다.
브랜치 이름 바꾸기
-
GitHub에서 리포지토리의 기본 페이지로 이동합니다.
-
왼쪽의 파일 트리 보기에서 분기 드롭다운 메뉴를 선택한 다음 모든 분기 보기를 클릭합니다. 통합 파일 편집기의 맨 위에도 분기 드롭다운 메뉴가 있습니다.
-
이름을 바꿀 분기 옆에 있는 드롭다운 메뉴를 선택한 다음 분기 이름 바꾸기를 클릭합니다****.
-
브랜치의 새 이름을 입력하세요.
-
로컬 환경에 대한 정보를 검토한 다음 분기 이름 바꾸기를 클릭합니다.
분기 이름이 변경된 후 로컬 복제본 업데이트
브랜치 이름을 GitHub에서 변경하면, 로컬 복제본을 가진 모든 협력자가 복제본을 업데이트해야 합니다.
컴퓨터의 리포지토리 로컬 복제본에서 다음 명령을 실행하여 기본 분기의 이름을 업데이트합니다.
git branch -m OLD-BRANCH-NAME NEW-BRANCH-NAME
git fetch origin
git branch -u origin/NEW-BRANCH-NAME NEW-BRANCH-NAME
git remote set-head origin -a
필요에 따라 다음 명령을 실행하여 이전 분기 이름에 대한 추적 참조를 제거합니다.
git remote prune origin