Git Rename Branch : Comment renommer une branche locale ou distante

Renommer une branche locale

Renommer une branche locale est un moyen simple mais efficace de garder notre projet organisé et de s'assurer que les noms des branches reflètent correctement leur contenu ou leur objectif.

Renommer une branche locale ne la renomme pas sur le dépôt distant. Si le cursus de la branche se fait à distance, nous devons le traiter séparément.

Conditions préalables

Avant de commencer, nous devons nous assurer que Git est installé et que nous sommes dans le répertoire du dépôt sur notre machine locale.

• Vérifiez l'installation : Assurez-vous que Git est installé localement. Nous pouvons le vérifier en lançant git --version dans le terminal ou l'invite de commande. S'il n'est pas installé, lisez ce tutoriel sur l'installation de Git ou visitez le site officiel de Git pour obtenir des instructions de téléchargement et d'installation.
• Naviguez jusqu'au répertoire du référentiel : Pour commencer, nous devons ouvrir un terminal ou une invite de commande et naviguer jusqu'au répertoire du projet Git pour lequel nous souhaitons renommer une branche.

Vérification de la branche

Avant de faire quoi que ce soit dans la branche, nous devons d'abord basculer dans cette branche à l'aide de la commande :

git checkout <current_branch_name>

Remplacez par le nom actuel de la branche.

Renommer la branche

Une fois la branche extraite, nous renommons la branche en utilisant :

git branch -m <new_branch_name>

Remplacez par le nouveau nom de la branche.

Verification

Nous pouvons vérifier que le nom a été modifié en listant toutes les branches à l'aide de la commande git branch. La branche actuelle sera précédée d'un astérisque (*).

Renommer une branche distante

Renommer une branche distante dans Git est une tâche qui implique quelques étapes supplémentaires pour s'assurer que les changements sont reflétés dans le dépôt distant.

Pousser les changements locaux

Avant de renommer une branche distante, nous devons nous assurer que la branche locale ne contient pas de travail qui ne se trouve pas encore dans la branche distante. Cela permet d'éviter que ces modifications ne soient perdues au cours du processus de renommage. Si vous n'êtes pas sûr de savoir comment pousser des modifications, consultez ce Tutoriel Git Push et Pull.

Renommer la branche locale

Avant de renommer la branche distante, nous devons d'abord renommer la branche localement, comme nous l'avons appris plus haut.

Pousser la nouvelle branche

Après avoir renommé la branche localement, nous pouvons pousser cette nouvelle branche vers le référentiel distant en utilisant :

git push origin -u <new_branch_name>

L'option -u définit la branche poussée comme la branche en amont de la branche locale. Ainsi, les futurs pushs et pulls de cette branche référenceront automatiquement le remote avec le nouveau nom.

Suppression de l'ancienne branche

Ce processus ne renomme pas une branche distante, mais crée une nouvelle copie de celle-ci avec un nouveau nom. Après cela, il est recommandé de nettoyer le référentiel en supprimant l'ancienne branche à l'aide de la commande suivante :

git push origin --delete <old_branch_name>

Si vous souhaitez approfondir vos connaissances sur le travail avec les branches dans Git, consultez le tutoriel Git Clone a Specific Branch (Cloner une branche spécifique).

Considérations importantes

Lorsque l'on renomme une branche distante dans Git, plusieurs aspects critiques requièrent notre attention afin de s'assurer que le processus est fluide et ne perturbe pas le flux de travail des collaborateurs du projet.

Nous devons toujours informer les autres membres de notre équipe du changement de nom de la branche. Cette communication permet d'éviter toute confusion, car ils peuvent rencontrer des erreurs s'ils essaient de tirer ou de pousser vers une branche qui n'existe plus sous son nom d'origine.

Les collaborateurs doivent renommer leurs copies locales de la branche en utilisant la commande git branch -m . De plus, ils devront réinitialiser leur branche en amont avec git push origin -u pour s'assurer que les poussées futures iront à la branche correcte.

S'il y a des demandes d'extraction ouvertes ciblant l'ancien nom de branche dans le dépôt distant, elles nécessiteront notre attention. Il se peut que nous devions les fermer et en créer de nouveaux pour la branche nouvellement nommée.

Renommer des branches dans les clients Git

La plupart des clients Git (par exemple GitHubGitKraken, Sourcetree, GitLab, etc.) offrent des options pour renommer les branches à travers leurs interfaces graphiques.

Pour renommer une branche sur GitHub, nous commençons par naviguer vers le dépôt. Ensuite, nous cliquons sur lemenu déroulant branch:

En bas du menu, cliquez sur Voir toutes les branches:

Ensuite, nous devons localiser la branche que nous souhaitons renommer et cliquer sur le menu déroulant à trois points sur la droite :

Enfin, nous cliquons sur l'option Option Renommer la branche et renommons la branche :

Conclusion

Renommer des branches dans Git joue un rôle crucial dans le maintien d'une structure de projet efficace et intuitive. 

Il est essentiel de faire la distinction entre renommer une branche localement et à distance, car chacune a ses propres étapes et implications sur le flux de travail.

Plus important encore, la communication avec l'équipe est primordiale. Le fait de tenir tout le monde au courant garantit une transition sans heurts et évite d'éventuelles perturbations du cycle de développement.

Si vous souhaitez en savoir plus sur Git, je vous recommande ce cours d'introduction à Git.