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, die zwar nicht häufig verwendet wird, aber durchaus nützlich sein kann.

Git ist in der Lage, seine Daten in einer einzigen Datei zu „bündeln“. Das kann in verschiedenen Situationen nützlich sein. Vielleicht ist Ihr Netzwerk ausgefallen und Sie möchten Änderungen an Ihre Mitarbeitenden senden. Vielleicht arbeiten Sie irgendwo außerhalb Ihres Unternehmens und haben aus Sicherheitsgründen keinen Zugang zum Firmen-Netzwerk. Möglicherweise ist Ihre Wireless-/Ethernet-Karte einfach kaputt. Oder Sie haben im Moment keinen Zugang zu einem gemeinsamen Server, Sie wollen 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 Sie an jemanden per E-Mail oder auf einem Flash-Laufwerk schicken können, um es dann in ein anderes Repository zu entpacken.

Lassen Sie uns ein einfaches Beispiel anschauen. Angenommen, Sie haben ein Repository mit zwei Commits:

Wenn Sie dieses Repository an jemanden schicken wollen und Sie keinen Zugriff auf ein Repository haben, um es zu pushen, oder wenn Sie einfach keins einrichten wollen, können Sie es mit git bundle create bündeln.

Sie haben 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 müssen Sie jede Referenz oder jeden spezifischen Bereich von Commits auflisten, die Sie einbeziehen möchten. Wenn Sie beabsichtigen, diese Datei irgendwo anders zu klonen, sollten Sie HEAD als Referenz hinzufügen, wie wir es hier getan haben.

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

Auf der anderen Seite nehmen wir an, dass Sie diese repo.bundle Datei erhalten haben und an dem Projekt mitarbeiten wollen. Sie können die Binärdatei in ein Verzeichnis klonen, ähnlich wie Sie es von einer URL aus tun würden.

Wenn Sie HEAD nicht in die Verweise integrieren können, müssen Sie auch -b master oder einen beliebigen anderen Branch angeben, da der Befehl sonst nicht weiß, welchen Branch er auschecken soll..

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

Zuerst müssen wir den Umfang der 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. Jetzt könnten Sie einfach das Gleiche tun und 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 müssen Sie die Differenz berechnen. Wie wir in Commit-Bereiche beschrieben haben, können Sie den Umfang der 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. Sie können 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, nun wollen wir sie bündeln. Wir machen das mit dem Befehl git bundle create, indem wir ihm einen Dateinamen zuweisen, der unser Bundle sein 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 Sie sehen möchten, welche Branches aus dem Bündel importiert werden können, gibt es auch einen Befehl, um nur die Kopfzeilen (engl. heads) aufzulisten:

Der Unterbefehl verify wird Ihnen auch die Kopfzeilen anzeigen. Es geht vielmehr darum, zu sehen, was man fetchen kann. Sie können 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 gemeinsam netzwerkähnliche Operationen zu nutzen, wenn Sie nicht über das richtige Netzwerk oder ein gemeinsam genutztes Repository verfügen, um das Gleiche zu tun.