3.5 Git Branching - Remote-Branches

Wenn du einen Branch mit der Welt teilen möchtest, musst du ihn auf einen Remote-Server hochladen, auf dem du Schreibrechte besitzt. Deine lokalen Branches, auf die du schreibst, werden nicht automatisch mit den Remotes synchronisiert – Du musst die Branches, die du freigeben möchtest, explizit pushen. Auf diese Weise kannst du private Branches, die du nicht veröffentlichen willst, zum Arbeiten benutzen und nur die Feature-Branches pushen, an denen du mitarbeiten willst.

Wenn du einen Branch namens serverfix besitzt, an dem du mit anderen arbeiten möchtest, dann kannst du diesen auf dieselbe Weise Hochladen wie deinen ersten Branch. Führe die Anweisung git push <remote> <branch> aus:

Das ist eine Art Abkürzung. Git erweitert den Branch-Namen serverfix automatisch zu refs/heads/serverfix:refs/heads/serverfix, was soviel bedeutet wie „Nimm meinen lokalen Branch serverfix und aktualisiere damit den serverfix Branch auf meinem Remote-Server“. Wir werden den Teil refs/heads/ in Kapitel 10 Git Interna noch näher beleuchten, du kannst ihn aber in der Regel auslassen. Du kannst auch die Anweisung git push origin serverfix:serverfix ausführen, was das Gleiche bewirkt – es bedeutet „Nimm meinen serverfix und mach ihn zum serverfix des Remote-Servers“. Du kannst dieses Format auch benutzen, um einen lokalen Branch in einen Remote-Branch mit anderem Namen zu pushen. Wenn du nicht willst, dass er auf dem Remote als serverfix bezeichnet wird, kannst du stattdessen git push origin serverfix:awesomebranch ausführen, um deinen lokalen serverfix Branch auf den awesomebranch Branch im Remote-Projekt zu pushen.

Das nächste Mal, wenn einer deiner Mitstreiter Daten vom Server abholt, wird er eine Referenz auf die Server-Version des Branches serverfix unter dem Remote-Branch origin/serverfix erhalten:

Es ist wichtig zu beachten, dass du bei einem Abruf, der neue Remote-Tracking-Branches abruft, nicht automatisch über lokale, bearbeitbare Kopien davon verfügst. Mit anderen Worten, in diesem Fall hast du keinen neuen Branch serverfix – Du hast nur einen Zeiger origin/serverfix, den du nicht ändern kannst.

Um diese Änderungen in deinem gegenwärtigen Arbeitsbranch einfließen zu lassen, kannst du die Anweisung git merge origin/serverfix ausführen. Wenn du deinen eigenen serverfix Branch haben willst, an dem du arbeiten kannst, kannst du ihn von deinem Remote-Tracking-Branch ableiten (engl. base):

Das erstellt dir einen lokalen Branch, an dem du arbeiten kannst, und der dort beginnt, wo origin/serverfix derzeit steht.

Das Auschecken eines lokalen Branches von einem Remote-Branch erzeugt automatisch einen sogenannten „Tracking-Branch“ (oder manchmal einen „Upstream-Branch“). Tracking-Branches sind lokale Branches, die eine direkte Beziehung zu einem Remote-Branch haben. Wenn du dich auf einem Tracking-Branch befindest und git pull eingibst, weiß Git automatisch, von welchem Server Daten abzuholen sind und in welchen Branch diese einfließen sollen.

Wenn du ein Repository klonst, wird automatisch ein master Branch erzeugt, welcher origin/master trackt. Du kannst jedoch auch andere Tracking-Branches erzeugen, wenn du wünschst – welche die Branches auf anderen Remotes folgen. Der einfachste Fall ist das Beispiel, dass du gerade gesehen hast, die Ausführung der Anweisung git checkout -b <branch> <remotename>/<branch>. Das ist eine übliche Operation, für die Git die Kurzform --track bereitstellt:

In der Tat ist dies so weit verbreitet, dass es sogar eine Abkürzung für diese Abkürzung gibt. Wenn der Branch-Name, den du zum Auschecken verwenden möchtest (a), nicht existiert und (b) genau mit einem Namen auf nur einem Remote übereinstimmt, erstellt Git einen Tracking-Branch für dich:

Um einen lokalen Branch mit einem anderen Namen als den entfernten Branch einzurichten, kannst du die erste Version mit einem anderen lokalen Branch-Namen verwenden:

Nun wird dein lokaler Branch sf automatisch von origin/serverfix pullen.

Wenn du bereits über einen lokalen Branch verfügst und ihn auf einen Remote-Branch festlegen möchtest, den du gerade gepullt hast, oder auf den von dir gefolgten Upstream-Branch ändern möchtest, kannst du die Option -u oder --set-upstream-to für git branch verwenden, um es jederzeit festzulegen.

Wenn du die Tracking-Branches sehen willst, die du eingerichtet hast, kannst du die Anweisung git branch zusammen mit der Option -vv ausführen. Das listet deine lokalen Branches zusammen mit weiteren Informationen auf, einschließlich was jeder Branch trackt und ob dein lokaler Branch voraus oder zurück liegt, oder auch beides.

Hier können wir also sehen, dass unser iss53 Branch den Branch origin/iss53 folgt und die Information „ahead 2“ bedeutet, dass wir zwei lokale Commits haben, welche noch nicht auf den Server hochgeladen wurden. Wir können außerdem sehen, dass unser master Branch origin/master folgt und auf den neuesten Stand ist. Als nächstes sehen wir, dass unser serverfix Branch den Branch server-fix-good auf unserem Server teamone folgt. „ahead 3, behind 1“ bedeutet, dass es einen Commit auf dem Server gibt, den wir noch nicht gemerged haben, und drei lokale Commits existieren, die wir noch nicht gepusht haben. Zum Schluss können wir sehen, dass unser testing Branch gar keinen Remote-Branch folgt.

Es ist wichtig zu beachten, dass diese Zahlen den Zustand zu dem Zeitpunkt beschreiben, als du zum letzten Mal Daten vom Server abgeholt hast. Diese Anweisung greift nicht auf die Server zu, sie liefert nur die Informationen, welche beim letzten Server-Kontakt lokal zwischengespeichert wurden. Wenn du gänzlich aktuelle Zahlen von „ahead“ und „behind“ willst, dann musst du, kurz bevor du die Anweisung ausführst, von all deinen Remote-Servern Daten abholen (fetch). Du kannst das so machen:

Die Anweisung git fetch holt alle Änderungen auf dem Server ab, die du zurzeit noch nicht hast. In deinem Arbeitsverzeichnis wird sie jedoch überhaupt nichts verändern. Sie wird einfach die Daten für dich holen und dir das Zusammenführen überlassen. Es gibt jedoch die Anweisung git pull, welche im Grunde genommen ein git fetch ist, dem in den meisten Fällen augenblicklich ein git merge folgt. Wenn du einen Tracking-Branch eingerichtet hast, wie im letzten Abschnitt gezeigt, indem du ihn explizit setzt oder indem du ihn mit den Befehlen clone oder checkout für dich hast erstellen lassen, dann sucht git pull nach dem Server und dem getrackten Branch. Git macht ein fetch vom Server und versucht dann diesen remote branch zu mergen.

Generell ist es besser, einfach explizit die Anweisungen git fetch und git merge zu benutzen, da die Magie der Anweisung git pull häufig verwirrend sein kann.

Stellen wir uns vor, du bist mit deinem Remote-Branch fertig. Du und deine Kollegen sind fertig mit einer neuen Funktion und haben sie in den Branch master des Remote-Servers (oder in welchem Branch auch immer sich dein stabiler Code befindet) einfließen lassen. Du kannst einen Remote-Branch löschen, indem du die Anweisung git push zusammen mit der Option --delete ausführst. Wenn du deinen serverfix Branch vom Server löschen willst, führst du folgende Anweisung aus:

Im Grunde genommen ist alles, was das bewirkt, dass der Zeiger vom Server entfernt wird. Der Git-Server bewahrt die Daten dort in der Regel eine Weile auf, bis eine Speicherbereinigung läuft. Wenn sie also versehentlich gelöscht wurden, ist es oft einfach, sie wiederherzustellen.