7.12 Git Tools - Bündeln

Obwohl wir die gängigen Methoden zum Übertragen von Git-Daten über ein Netzwerk (HTTP, SSH usw.) behandelt haben, gibt es tatsächlich noch eine weitere Methode, die nicht häufig verwendet wird, aber tatsächlich sehr nützlich sein kann.

Git ist in der Lage, seine Daten in eine einzige Datei zu „bündeln“. Dies kann in verschiedenen Szenarien nützlich sein. Vielleicht ist Ihr Netzwerk ausgefallen und Sie möchten Änderungen an Ihre Kollegen senden. Vielleicht arbeiten Sie auswärts und haben aus Sicherheitsgründen keinen Zugriff auf das lokale Netzwerk. Vielleicht ist Ihre Wireless/Ethernet-Karte gerade kaputtgegangen. Vielleicht haben Sie im Moment keinen Zugriff auf einen gemeinsamen Server, möchten jemandem Updates per E-Mail senden und möchten nicht 40 Commits über format-patch übertragen.

Hier kann der Befehl git bundle hilfreich sein. Der Befehl bundle packt alles, was normalerweise mit einem git push Befehl über die Leitung gesendet würde, in eine Binärdatei, die Sie per E-Mail an jemanden senden oder auf einen USB-Stick kopieren und dann in ein anderes Repository entpacken können.

Sehen wir uns ein einfaches Beispiel an. Nehmen wir an, Sie haben ein Repository mit zwei Commits

Wenn Sie dieses Repository an jemanden senden möchten und keinen Zugriff auf ein Repository haben, auf das Sie pushen können, oder einfach keines einrichten möchten, können Sie es mit git bundle create bündeln.

Jetzt haben Sie eine Datei namens repo.bundle, die alle Daten enthält, die zum Neuerstellen des master-Branches des Repositorys benötigt werden. Mit dem Befehl bundle müssen Sie jeden Verweis oder einen bestimmten Commit-Bereich auflisten, der enthalten sein soll. Wenn Sie beabsichtigen, dies woanders zu klonen, sollten Sie auch HEAD als Verweis hinzufügen, so wie wir es hier getan haben.

Sie können diese Datei repo.bundle per E-Mail an jemand anderen senden oder sie auf einen USB-Stick kopieren und ihn persönlich überbringen.

Auf der anderen Seite, nehmen wir an, Ihnen wird diese Datei repo.bundle zugesandt und Sie möchten an dem Projekt arbeiten. Sie können aus der Binärdatei in ein Verzeichnis klonen, ähnlich wie Sie es von einer URL tun würden.

Wenn Sie HEAD nicht in die Verweise aufnehmen, müssen Sie auch -b master oder einen anderen enthaltenen Branch angeben, da Git sonst nicht weiß, welchen Branch es auschecken soll.

Nehmen wir nun an, Sie führen drei Commits durch und möchten die neuen Commits über ein Bundle auf einem USB-Stick oder per E-Mail senden.

Zuerst müssen wir den Commit-Bereich ermitteln, den wir in das Bundle aufnehmen möchten. Im Gegensatz zu den Netzwerkprotokollen, die für uns den minimalen Datensatz für die Übertragung über das Netzwerk ermitteln, müssen wir dies manuell ermitteln. Nun könnten Sie genauso vorgehen und das gesamte Repository bündeln, was funktionieren wird, aber es ist besser, nur die Differenz zu bündeln – nur die drei Commits, die wir gerade lokal gemacht haben.

Dazu müssen Sie die Differenz berechnen. Wie bereits in Commit Ranges beschrieben, können Sie einen Commit-Bereich auf verschiedene Weise angeben. Um die drei Commits zu erhalten, die wir in unserem master-Branch haben und die nicht im Branch enthalten waren, den wir ursprünglich geklont haben, können wir etwas wie origin/master..master oder master ^origin/master verwenden. Sie können dies mit dem Befehl log testen.

Nachdem wir nun die Liste der Commits haben, die wir in das Bundle aufnehmen möchten, bündeln wir sie. Dies geschieht mit dem Befehl git bundle create, wobei wir den Dateinamen, den wir für unser Bundle wünschen, und den Commit-Bereich, den wir hineinpacken möchten, angeben.

Jetzt haben wir eine Datei commits.bundle in unserem Verzeichnis. Wenn wir diese an unseren Partner senden, kann sie sie in das ursprüngliche Repository importieren, auch wenn inzwischen dort weitere Arbeit geleistet wurde.

Wenn sie das Bundle erhält, kann sie es überprüfen, um zu sehen, was es enthält, bevor sie es in ihr Repository importiert. Der erste Befehl ist bundle verify, der sicherstellt, dass die Datei tatsächlich ein gültiges Git-Bundle ist und dass Sie alle notwendigen Vorfahren haben, um es korrekt wiederherzustellen.

Wenn der Bundler ein Bundle nur mit den letzten beiden Commits erstellt hätte, anstatt mit allen drei, hätte das ursprüngliche Repository es nicht importieren können, da ihm die erforderliche Historie fehlt. Der Befehl verify hätte stattdessen wie folgt ausgesehen:

Unser erstes Bundle ist jedoch gültig, sodass wir Commits daraus abrufen können. Wenn Sie sehen möchten, welche Branches im Bundle enthalten sind, die importiert werden können, gibt es auch einen Befehl, um nur die Heads aufzulisten:

Der Unterbefehl verify gibt ebenfalls die Heads aus. Der Punkt ist, zu sehen, was abgerufen werden kann, sodass Sie die Befehle fetch oder pull verwenden können, um Commits aus diesem Bundle zu importieren. Hier rufen wir den master-Branch des Bundles in einen Branch namens other-master in unserem Repository ab:

Jetzt können wir sehen, dass wir die importierten Commits auf dem Branch other-master haben, sowie alle Commits, die wir inzwischen auf unserem eigenen master-Branch gemacht haben.

git bundle kann also sehr nützlich sein, um Netzwerk-ähnliche Operationen auszutauschen oder durchzuführen, wenn Sie nicht über das richtige Netzwerk oder ein gemeinsames Repository verfügen.