Enterprise Server 3.21 в настоящее время доступен в качестве кандидата на выпуск.

Переименование ветви

Вы можете изменить имя ветви в репозитории.

Кто может использовать эту функцию?

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-адресов необработанных файлов. Также GitHub не выполняет перенаправления, если пользователи выполняют a git pull для предыдущего имени ветки.

          GitHub Actions Рабочие процессы не следуют за переименованием, поэтому если ваш репозиторий публикует действие, любой, кто использует это `@{old-branch-name}` действие, сломается. Стоит рассмотреть возможность добавления новой ветки с оригинальным содержимым, а также дополнительного коммита с указанием названия Закрытие ветки и предложения мигрировать на новое имя ветки.

Кто может переименовать филиал

Большинство ветвей может быть переименовано любым пользователем с разрешением записи в репозиторий.

Некоторые ветки могут быть переименованы только администратором репозитория: ветвью по умолчанию репозитория и любой веткой, покрываемой защитой ветки или набором правил на уровне репозитория.

Организационные правила, применимые к веткам репозитория, не позволят администратору репозитория переименовывать ветки целевого репозитория или изменять ветку по умолчанию на другую.

Администраторы репозитория могут создавать и удалять ветви до тех пор, пока у них есть соответствующие разрешения.

Переименование ветви

  1. На GitHubперейдите на главную страницу репозитория.

  2. В представлении дерева файлов слева выберите раскрывающееся меню "git-branch" aria-hidden="true" aria-label="git-branch" %} в раскрывающемся меню "git-branch" %} и выберите команду Просмотреть все ветви. Вы также можете найти раскрывающееся меню ветви в верхней части интегрированного редактора файлов.

    Снимок экрана: представление дерева файлов для репозитория. Раскрывающееся меню для ветвей развернуто и описано в темно-оранжевый цвет.

  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