Wie kann man den Branch-Namen in Bitbucket ändern?
- Warum den Branch-Namen ändern?
- Branch-Namen lokal ändern
- Branch auf Bitbucket aktualisieren
- Lokale Einrichtung für Zusammenarbeit anpassen
- Zusammenfassung
Das Ändern eines Branch-Namens in Bitbucket ist keine direkte Funktion, die über die Weboberfläche angeboten wird. Stattdessen muss diese Änderung lokal über Git durchgeführt und anschließend auf Bitbucket aktualisiert werden. Im Folgenden wird ausführlich erläutert, wie man den Branch-Namen ändert und dabei mögliche Probleme vermeidet.
Warum den Branch-Namen ändern?
Manchmal ist der ursprüngliche Branch-Name nicht aussagekräftig, entspricht nicht dem Namensschema des Teams oder enthält Tippfehler. In solchen Fällen ist es sinnvoll, den Branch-Namen anzupassen, um die Übersicht zu verbessern und die weitere Zusammenarbeit zu erleichtern.
Branch-Namen lokal ändern
Der erste Schritt besteht darin, den Branch-Namen lokal zu ändern. Das geschieht mit Git-Befehlen auf der Kommandozeile. Wenn man sich bereits auf dem umzubenennenden Branch befindet, kann man den Befehl git branch -m neuer-branch-name verwenden, um den Namen direkt zu ändern. Befindet man sich auf einem anderen Branch, ist die Syntax git branch -m alter-branch-name neuer-branch-name.
Branch auf Bitbucket aktualisieren
Nachdem der Branch lokal umbenannt wurde, muss der neue Branch-Name in das entfernte Repository (Bitbucket) übertragen werden. Das erfolgt mit git push origin neuer-branch-name. Anschließend sollte der alte Branch, der unter dem alten Namen noch existiert, vom Remote-Repository gelöscht werden, um Verwirrung zu vermeiden. Dies geschieht mit dem Befehl git push origin --delete alter-branch-name.
Lokale Einrichtung für Zusammenarbeit anpassen
Falls andere Entwickler den alten Branch bereits verwenden oder darauf referenzieren, sollten diese ebenfalls ihre lokalen Repositories anpassen. Das bedeutet, sie müssen den neuen Branch auschecken und gegebenenfalls den alten löschen. Außerdem ist es empfehlenswert, alle offenen Pull Requests oder Merges auf Bitbucket auf den neuen Branch-Namen umzustellen oder zu schließen und neu zu erstellen.
Zusammenfassung
Bitbucket bietet selbst keine direkte Möglichkeit, Branch-Namen innerhalb der Weboberfläche zu ändern. Die Umbenennung erfolgt über Git-Befehle lokal mit git branch -m, gefolgt vom Push des neuen Branches auf Bitbucket und dem Löschen des alten Branches im Remote-Repository. So bleibt der Verlauf erhalten und die Zusammenarbeit wird nicht gestört.