Em outro post, falamos mais sobre branch e é a primeira parte deste tutorial, para ver o post acesse: Git - O que é um branch

Neste post vamos ver como renomear um branch do git e entender um pouco sobre este mecanismo.

Renomeando um branch local

Para renomear um branch no git estando dentro do branch basta utilizar a opção -m, veja:

git branch -m branch-002

Renomear um branch local de outro branch

Caso esteja em outro branch precisamos mudar um pouco o comando para renomear o branch. Para mostrar este exemplo vamos voltar ao branch master:

git checkout master

Agora podemos renomear o branch usando o comando:

git branch -m branch-002 branch-003

Digite git branch para visualizar todos os branches. Será exibido:

  branch-003
* master

Renomeando um branch remoto com git

Não é possível renomear um branch remoto diretamente. O processo para renomear envolve três etapas:

• Renomear o branch local
• Remover o branch remoto com nome antigo e enviar novo branch com o novo nome
• Redefinir o upstream branch

Para exemplificar faremos o push (enviar para o servidor) do branch criado.

Para isso execute respectivamente os comandos para fazer o checkout para o branch branch-003 e execute o comando:

git push -u origin branch-003

Execute o comando para verificar:

git branch -a

A saída deve ser:

* branch-003
  master
  remotes/origin/HEAD -> origin/master
  remotes/origin/branch-003
  remotes/origin/master

Renomear o branch local

Para renomear o branch local siga as orientações das etapas anteriores. Para o exemplo utilizei o seguinte comando:

git branch -m feature/001

Remover o branch remoto com nome antigo e enviar novo branch com o novo nome

Você pode fazer isso de forma simples com o seguinte comando:

git push origin :branch-003 feature/001

O retorno deve ser algo similar a isso:

To https://github.com/receitas-de-codigo/demo-jms.git
 - [deleted]         branch-003
 * [new branch]      feature/001 -> feature/001

Redefinir o upstream branch

Por fim, redefina o upstream para o branch local com novo nome e você terminou de renomear.

git push origin -u feature/001

O retorno deve ser:

Branch feature/001 set up to track remote branch feature/001 from origin.

Não esqueca de deixar suas dúvidas nos comentários e compartilhar este post.