분기 이름 바꾸기

리포지토리에서 분기의 이름을 변경할 수 있습니다.

누가 이 기능을 사용할 수 있는 있나요?

People with write permissions to a repository can rename a branch in the repository unless it is the default branch or a protected branch. People with admin permissions can rename the default branch and protected branches.

이 문서의 내용

분기 이름 바꾸기 정보

GitHub.com의 리포지토리에서 분기 이름을 바꿀 수 있습니다. 분기에 대한 자세한 내용은 "분기 정보"을(를) 참조하세요.

GitHub.com에서 분기의 이름을 바꾸면 이전 분기 이름이 포함된 모든 URL이 이름이 바뀐 분기에 해당하는 URL로 자동으로 리디렉션됩니다. 분기 보호 정책도 업데이트되며 끌어오기 요청 열기(포크 포함) 및 초안 릴리스에 대한 베이스 분기도 업데이트됩니다. 이름이 바뀐 분기가 열린 끌어오기 요청의 헤드 분기인 경우, 이 끌어오기 요청은 종료됩니다.

리포지토리의 기본값 설정 분기의 이름 바꾸기가 완료되면 GitHub에서 리포지토리의 홈페이지에 기여자에게 로컬 Git 환경을 업데이트하도록 지시하는 지침을 제공합니다.

파일 URL은 자동으로 리디렉션되지만 원시 파일 URL은 리디렉션되지 않습니다. 또한 GitHub은(는) 사용자가 이전 분기 이름에 대해 git pull을(를) 수행하는 경우 리디렉션을 수행하지 않습니다.

GitHub Actions 워크플로는 이름 바꾸기를 따르지 않으므로 리포지토리에서 작업을 게시하면 @{old-branch-name}을(를) 통해 해당 작업을 사용하는 모든 사용자가 중단됩니다. 원래 콘텐츠가 포함된 새 분기를 추가하고 분기 이름이 더 이상 사용되지 않는다고 보고하고 사용자가 새 분기 이름으로 마이그레이션하도록 제안하는 다른 커밋을 추가하는 것이 좋습니다.

분기 이름 바꾸기

  1. GitHub.com에서 리포지토리의 기본 페이지로 이동합니다.

  2. 왼쪽의 파일 트리 보기에서 분기 드롭다운 메뉴를 선택한 다음 모든 분기 보기를 클릭합니다. 통합 파일 편집기의 맨 위에도 분기 드롭다운 메뉴가 있습니다.

    리포지토리의 파일 트리 보기 스크린샷 분기의 드롭다운 메뉴가 확장되고 진한 주황색 윤곽선으로 표시되어 있습니다.

  3. 이름을 바꿀 분기 옆에 있는을(를) 클릭합니다.

    분기 목록의 분기 스크린샷입니다. 연필 아이콘이 주황색 윤곽선으로 강조 표시되어 있습니다.

  4. 분기의 새 이름을 입력합니다.

  5. 로컬 환경에 대한 정보를 검토한 다음 분기 이름 바꾸기를 클릭합니다.

분기 이름이 변경된 후 로컬 복제본 업데이트

GitHub Enterprise Cloud의 리포지토리에서 분기의 이름을 바꾼 후에는 리포지토리의 로컬 복제본이 있는 모든 공동 작업자가 복제본을 업데이트해야 합니다.

컴퓨터의 리포지토리 로컬 복제본에서 다음 명령을 실행하여 기본 분기의 이름을 업데이트합니다.

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