Skip to main content

이 버전의 GitHub Enterprise Server는 다음 날짜에 중단됩니다. 2026-06-02. 중요한 보안 문제에 대해서도 패치 릴리스가 이루어지지 않습니다. 더 뛰어난 성능, 향상된 보안, 새로운 기능을 위해 최신 버전의 GitHub Enterprise Server로 업그레이드합니다. 업그레이드에 대한 도움말은 GitHub Enterprise 지원에 문의하세요.

브랜치 이름 바꾸기

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

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

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

브랜치 이름 변경에 대한 설명

리포지토리에서 GitHub Enterprise Server 인스턴스 브랜치의 이름을 변경할 수 있습니다. 분기에 대한 자세한 내용은 브랜치 정보을(를) 참조하세요.

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

리포지토리의 기본 분기 이름이 바뀐 GitHub 경우 리포지토리의 홈페이지에 대한 지침을 제공하여 기여자에게 로컬 Git 환경을 업데이트하도록 지시합니다.

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

          GitHub Actions 워크플로는 이름 변경을 따라가지 않으므로 리포지토리에서 작업을 게시할 경우, `@{old-branch-name}`와 함께 해당 작업을 사용하는 모든 사용자의 기능이 중단될 수 있습니다. 기존 콘텐츠가 포함된 새 브랜치를 추가하고, 브랜치 이름이 닫기임을 보고하며, 사용자가 새 브랜치 이름으로 이동하도록 권장하는 추가 커밋을 고려해 보세요.

누가 분기 이름을 바꿀 수 있나요?

대부분의 분기는 리포지토리에 대한 쓰기 권한이 있는 모든 사용자가 이름을 바꿀 수 있습니다.

일부 분기는 리포지토리 관리자(리포지토리의 기본 분기) 및 분기 보호 또는 리포지토리 수준 분기 규칙 집합이 적용되는 분기만 이름을 바꿀 수 있습니다.

리포지토리의 분기에 적용되는 조직 규칙 집합은 리포지토리 관리자가 대상 리포지토리의 분기 이름을 바꾸거나 기본 분기를 다른 분기로 변경할 수 없습니다.

리포지토리 관리자는 적절한 권한이 있는 경우에만 분기를 만들고 삭제할 수 있습니다.

브랜치 이름 바꾸기

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

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

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

  3. 이름을 바꿀 분기 옆에 있는 드롭다운 메뉴를 선택한 다음 분기 이름 바꾸기를 클릭합니다****.

  4. 브랜치의 새 이름을 입력하세요.

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

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

브랜치 이름을 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