Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Esta versão do GitHub Enterprise foi descontinuada em 2022-06-03. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Renomear um branch

É possível alterar o nome de um branch em um repositório.

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

Sobre a renomeação de branches

Você pode renomear um branch em um repositório em your GitHub Enterprise Server instance. Para obter mais informações sobre os branches, consulte "Sobre os branches)."

Ao renomear um branch em your GitHub Enterprise Server instance, todas as URLs que contiverem o nome do branch antigo serão automaticamente redirecionadas para a URL equivalente para o branch renomeado. Atualizam-se também as políticas de proteção de branch também, bem como o branch base para pull requests abertos (incluindo aqueles para bifurcações) e rascunhos de versões. Depois que a renomeação for concluída, GitHub fornecerá instruções na página inicial do repositório direcionando os colaboradores para atualizar seus ambientes do Git locais.

Embora as URLs do arquivo sejam automaticamente redirecionadas, as URLs do arquivo não processado não são redirecionadas. Além disso, GitHub não realiza nenhum redirecionamento se os usuários executarem um git pull para o nome do branch anterior.

Os fluxos de trabalho de GitHub Actions não seguem renomes. Portanto, se o repositório publicar uma ação, qualquer pessoa que usar essa ação com @{old-branch-name} vai quebrar. Você deve considerar adicionar um novo branch com o conteúdo original mais um relatório de commit adicional informando que o nome do branch está obsoleto e sugerindo que os usuários façam a migração para o novo nome do branche.

Renomear um branch

  1. No your GitHub Enterprise Server instance, navegue até a página principal do repositório.
  2. Above the list of files, click Branches. Link de branches numa página de visão geral
  3. Na lista de branches, �  direita do branch que você deseja renomear, clique em . Ícone do lápis �  direita do branch que você deseja renomear
  4. Digite um novo nome para o branch. Campo de texto para digitar o novo nome do branch
  5. Revise as informações sobre ambientes locais e clique em Renomear o branch. Informações de ambiente local e botão para "Renomear o branch"

Atualizar um clone local após alterações de nome do branch

Após renomear um branch em um repositório em GitHub Enterprise Server, qualquer colaborador com um clone local do repositório deverá atualizar o clone.

A partir do clone local do repositório em um computador, execute os seguintes comandos para atualizar o nome do branch padrão.

$ 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

Opcionalmente, execute o comando a seguir para remover as referências de rastreamento para o nome do branch antigo.

$ git remote prune origin