7.12 Git Tools - Bundling

Wir haben zwar die üblichen Methoden zur Übertragung von Git-Daten über ein Netzwerk (HTTP, SSH usw.) behandelt, aber es gibt noch eine weitere Möglichkeit. Diese wird zwar nicht häufig verwendet, aber sie kann durchaus nützlich sein.

Git ist in der Lage, seine Daten in einer einzigen Datei zu „bündeln“. Das kann in verschiedenen Situationen nützlich sein. Vielleicht ist dein Netzwerk ausgefallen und du möchtest Änderungen an deine Mitstreiter senden. Vielleicht arbeitest du irgendwo außerhalb deines Unternehmens und hast aus Sicherheitsgründen keinen Zugang zum Firmen-Netzwerk. Möglicherweise ist deine Wireless-/Ethernet-Karte einfach kaputt. Oder du hast im Moment keinen Zugang zu einem gemeinsamen Server. Du willst jemandem Updates per E-Mail schicken und keine 40 Commits per format-patch übertragen.

Hier kann die Funktion git bundle behilflich sein. Der Befehl bundle packt alles, was normalerweise mit einem git push Befehl über die Leitung geschoben wird, in eine Binärdatei, die du an jemanden per E-Mail oder auf einem Flash-Laufwerk schicken kannst, um es dann in ein anderes Repository zu entpacken.

Lass uns ein einfaches Beispiel anschauen. Angenommen, du hast ein Repository mit zwei Commits:

Wenn du dieses Repository an jemanden schicken willst und du keinen Zugriff auf ein Repository hast, um es zu pushen, oder wenn du einfach keins einrichten willst, kannst du es mit git bundle create bündeln.

Du hast jetzt eine Datei mit der Bezeichnung repo.bundle, die alle Daten enthält, die benötigt werden, um den master Branch des Repositorys neu zu erstellen. Mit dem Kommando bundle musst du jede Referenz oder jeden spezifischen Bereich von Commits auflisten, die du einbeziehen möchtest. Wenn du beabsichtigt, diese Datei irgendwo anders zu klonen, solltest du HEAD als Referenz hinzufügen, wie wir es hier getan haben.

Du kannst diese repo.bundle Datei per E-Mail an eine andere Person schicken oder sie auf einem USB-Laufwerk speichern und übergeben.

Nun nehmen wir an, dass du diese repo.bundle Datei erhalten hast und an dem Projekt mitarbeiten willst. Du kannst die Binärdatei in ein Verzeichnis klonen, ähnlich wie du es von einer URL aus tun würdest.

Wenn du HEAD nicht in die Referenzen integrierst, musst du -b master oder einen beliebigen anderen Branch angeben, da der Befehl sonst nicht weiß, welchen Branch er auschecken soll.

Nehmen wir an, du machst drei Commits darauf und willst die neuen Commits über ein Bündel auf einem USB-Stick oder per E-Mail zurückschicken.

Zuerst müssen wir die Commits bestimmen, die wir in das Bündel aufnehmen wollen. Im Gegensatz zu den Netzwerkprotokollen, die für uns den minimalen Datensatz für die Übertragung über das Netzwerk festlegen, müssen wir das hier manuell herausfinden. Du könntest einfach das gesamte Repository bündeln. Das wird zwar funktionieren, aber es ist besser, nur die Differenz zu bündeln – einfach nur die drei Commits, die wir gerade lokal gemacht hatten.

Dazu musst du die Differenz berechnen. Wie wir in Commit-Bereiche beschrieben haben, kannst du die Commits auf verschiedene Weise festlegen. Um die drei Commits zu bestimmen, die wir in unserem master Branch vorliegen haben und die nicht in dem Branch waren als wir ihn geklont haben, könnten wir zum Beispiel origin/master..master oder master ^origin/master benutzen. Du kannst die Ausführung mit dem Befehl log überprüfen und testen.

Jetzt haben wir unsere Liste der Commits, die wir in das Bundle aufnehmen wollen. Wir machen das mit dem Befehl git bundle create, indem wir ihm einen Dateinamen angeben (wie das Bündel heißen soll) und den Umfang der Commits angeben, die wir aufnehmen wollen.

Jetzt haben wir eine commits.bundle Datei in unserem Verzeichnis. Wenn wir diese Datei an unsere Partnerin schicken, kann sie diese in das originale Repository importieren, auch wenn dort zwischenzeitlich weitere Arbeiten stattgefunden haben.

Wenn sie das Bündel erhält, kann sie den Inhalt prüfen, bevor sie es in ihr Repository importiert. Der erste Befehl ist der Befehl bundle verify, der sicherstellt, dass die Datei tatsächlich ein gültiges Git-Bundle ist und dass diese alle notwendigen Vorgänger hat, um sie korrekt wiederherzustellen.

Hätte der Bündel-Ersteller nur die beiden letzten Commits gebündelt und nicht alle drei, wäre das ursprüngliche Repository nicht in der Lage, es zu importieren, da ihm der erforderliche Verlauf fehlt. Das Kommando verify hätte stattdessen so ausgesehen:

Unser erstes Bündel ist jedoch gültig, so dass wir daraus die Commits abrufen können (engl. fetch). Wenn du sehen möchtest, welche Branches aus dem Bündel importiert werden können, gibt es auch einen Befehl, um nur die HEADS aufzulisten:

Der Unterbefehl verify wird dir auch die HEADS anzeigen. Es geht darum, zu sehen, was man übernehmen kann. Du kannst dann die Befehle fetch oder pull verwenden, um Commits aus diesem Bündel zu importieren. Hier holen wir den master Branch aus dem Bündel in einen Branch mit dem Namen other-master in unser Repository:

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

Der Befehl git-bundle kann also sehr nützlich sein, um Arbeit weiterzugeben oder um netzwerk-ähnliche Operationen durchzuführen, falls du nicht über ein gemeinsames Netzwerk oder ein gemeinsam genutztes Repository verfügst.