3.5 Git Branching - Remote-Branches

Wenn Sie einen Branch mit der Welt teilen möchten, müssen Sie ihn auf ein Remote pushen, auf das Sie Schreibzugriff haben. Ihre lokalen Branches werden nicht automatisch mit den Remotes synchronisiert, auf die Sie schreiben – Sie müssen die Branches, die Sie teilen möchten, explizit pushen. Auf diese Weise können Sie private Branches für Arbeiten verwenden, die Sie nicht teilen möchten, und nur die Topic-Branches hochladen, an denen Sie zusammenarbeiten möchten.

Wenn Sie einen Branch namens serverfix haben, an dem Sie mit anderen arbeiten möchten, können Sie ihn auf die gleiche Weise hochladen, wie Sie Ihren ersten Branch hochgeladen haben. Führen Sie git push <remote> <branch> aus.

Dies ist eine Art Abkürzung. Git erweitert den Branch-Namen serverfix automatisch zu refs/heads/serverfix:refs/heads/serverfix, was bedeutet: „Nimm meinen lokalen serverfix-Branch und pushe ihn, um den serverfix-Branch des Remotes zu aktualisieren.“ Wir werden den refs/heads/-Teil im Detail in Git Internals behandeln, aber Sie können ihn im Allgemeinen weglassen. Sie können auch git push origin serverfix:serverfix ausführen, was dasselbe tut – es bedeutet: „Nimm mein serverfix und mache es zum serverfix des Remotes.“ Sie können dieses Format verwenden, um einen lokalen Branch in einen Remote-Branch zu pushen, der anders benannt ist. Wenn Sie nicht möchten, dass er auf dem Remote serverfix heißt, könnten Sie stattdessen git push origin serverfix:awesomebranch ausführen, um Ihren lokalen serverfix-Branch in den awesomebranch-Branch des Remote-Projekts zu pushen.

Wenn einer Ihrer Mitarbeiter das nächste Mal vom Server abruft, erhält er eine Referenz darauf, wo sich die Serverversion von serverfix unter dem Remote-Branch origin/serverfix befindet.

Es ist wichtig zu beachten, dass Sie, wenn Sie einen Fetch durchführen, der neue Remote-Tracking-Branches herunterlädt, nicht automatisch lokale, bearbeitbare Kopien davon erhalten. Mit anderen Worten, in diesem Fall haben Sie keinen neuen serverfix-Branch – Sie haben nur einen origin/serverfix-Zeiger, den Sie nicht ändern können.

Um diese Arbeit in Ihren aktuellen Arbeits-Branch zusammenzuführen, können Sie git merge origin/serverfix ausführen. Wenn Sie Ihren eigenen serverfix-Branch haben möchten, an dem Sie arbeiten können, können Sie ihn auf Ihrem Remote-Tracking-Branch basieren lassen.

Dies gibt Ihnen einen lokalen Branch, an dem Sie arbeiten können, der dort beginnt, wo origin/serverfix ist.

Das Auschecken eines lokalen Branches von einem Remote-Tracking-Branch erstellt automatisch einen sogenannten „Tracking-Branch“ (und der Branch, den er verfolgt, wird als „Upstream-Branch“ bezeichnet). Tracking-Branches sind lokale Branches, die eine direkte Beziehung zu einem Remote-Branch haben. Wenn Sie sich auf einem Tracking-Branch befinden und git pull eingeben, weiß Git automatisch, von welchem Server abgerufen und welcher Branch zusammengeführt werden soll.

Wenn Sie ein Repository klonen, erstellt es im Allgemeinen automatisch einen master-Branch, der origin/master verfolgt. Sie können jedoch auch andere Tracking-Branches einrichten, wenn Sie dies wünschen – solche, die Branches auf anderen Remotes verfolgen, oder die nicht den master-Branch verfolgen. Der einfache Fall ist das Beispiel, das Sie gerade gesehen haben: das Ausführen von git checkout -b <branch> <remote>/<branch>. Dies ist eine so häufige Operation, dass Git die Kurzform --track bereitstellt.

Tatsächlich ist dies so üblich, dass es sogar eine Abkürzung für diese Abkürzung gibt. Wenn der Name des Branches, den Sie auschecken möchten (a) nicht existiert und (b) genau mit einem Namen auf nur einem Remote übereinstimmt, erstellt Git automatisch einen Tracking-Branch für Sie.

Um einen lokalen Branch mit einem anderen Namen als dem Remote-Branch einzurichten, können Sie ganz einfach die erste Version mit einem anderen lokalen Branch-Namen verwenden.

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

Wenn Sie bereits einen lokalen Branch haben und ihn auf einen gerade heruntergeladenen Remote-Branch einstellen möchten oder den Upstream-Branch ändern möchten, den Sie verfolgen, können Sie die Option -u oder --set-upstream-to von git branch verwenden, um ihn jederzeit explizit festzulegen.

Wenn Sie sehen möchten, welche Tracking-Branches Sie eingerichtet haben, können Sie die Option -vv von git branch verwenden. Dies listet Ihre lokalen Branches mit zusätzlichen Informationen auf, einschließlich dessen, was jeder Branch verfolgt, und ob Ihr lokaler Branch voraus, zurück oder beides ist.

Hier sehen wir, dass unser iss53-Branch origin/iss53 verfolgt und zwei Commits voraus ist, was bedeutet, dass wir zwei Commits lokal haben, die noch nicht auf den Server gepusht wurden. Wir können auch sehen, dass unser master-Branch origin/master verfolgt und auf dem neuesten Stand ist. Als Nächstes sehen wir, dass unser serverfix-Branch den server-fix-good-Branch auf unserem teamone-Server verfolgt und drei Commits voraus und einen Commit zurück ist, was bedeutet, dass ein Commit auf dem Server vorhanden ist, den wir noch nicht zusammengeführt haben, und drei Commits lokal, die wir noch nicht gepusht haben. Schließlich können wir sehen, dass unser testing-Branch keinen Remote-Branch verfolgt.

Es ist wichtig zu beachten, dass diese Zahlen nur seit dem letzten Abruf von jedem Server gelten. Dieser Befehl greift nicht auf die Server zu, er informiert Sie über das, was er lokal von diesen Servern zwischengespeichert hat. Wenn Sie vollständig aktuelle Zahlen für „voraus“ und „zurück“ haben möchten, müssen Sie sich von allen Ihren Remotes abrufen, bevor Sie dies ausführen. Sie könnten das so tun:

Während der Befehl git fetch alle Änderungen auf dem Server abruft, die Sie noch nicht haben, ändert er Ihr Arbeitsverzeichnis überhaupt nicht. Er holt nur die Daten für Sie und lässt Sie sie selbst zusammenführen. Es gibt jedoch einen Befehl namens git pull, der im Wesentlichen ein git fetch ist, gefolgt von einem git merge in den meisten Fällen. Wenn Sie einen Tracking-Branch eingerichtet haben, wie im letzten Abschnitt gezeigt, entweder durch explizites Festlegen oder durch automatische Erstellung durch die Befehle clone oder checkout, sucht git pull, von welchem Server und welchem Branch Ihr aktueller Branch verfolgt wird, ruft von diesem Server ab und versucht dann, diesen Remote-Branch zusammenzuführen.

Angenommen, Sie sind mit einem Remote-Branch fertig – sagen wir, Sie und Ihre Mitarbeiter haben eine Funktion abgeschlossen und sie in den master-Branch Ihres Remotes (oder welchen Branch auch immer Ihre stabile Codezeile ist) zusammengeführt. Sie können einen Remote-Branch mit der Option --delete von git push löschen. Wenn Sie Ihren serverfix-Branch vom Server löschen möchten, führen Sie Folgendes aus:

Im Grunde entfernt dies nur den Zeiger vom Server. Der Git-Server behält die Daten normalerweise eine Weile, bis eine Garbage Collection ausgeführt wird. Wenn sie also versehentlich gelöscht wurde, ist sie oft leicht wiederherzustellen.