bundling.asc

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:

$ git log
commit 9a466c572fe88b195efd356c3f2bbeccdb504102
Author: Scott Chacon <[email protected]>
Date:   Wed Mar 10 07:34:10 2010 -0800

    Second commit

commit b1ec3248f39900d2a406049d762aa68e9641be25
Author: Scott Chacon <[email protected]>
Date:   Wed Mar 10 07:34:01 2010 -0800

    First commit

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.

$ git bundle create repo.bundle HEAD master
Counting objects: 6, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (6/6), 441 bytes, done.
Total 6 (delta 0), reused 0 (delta 0)

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.

$ git clone repo.bundle repo
Cloning into 'repo'...
...
$ cd repo
$ git log --oneline
9a466c5 Second commit
b1ec324 First commit

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.

$ git log --oneline
71b84da Last commit - second repo
c99cf5b Fourth commit - second repo
7011d3d Third commit - second repo
9a466c5 Second commit
b1ec324 First commit

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 ch07-git-tools.asc 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.

$ git log --oneline master ^origin/master
71b84da Last commit - second repo
c99cf5b Fourth commit - second repo
7011d3d Third commit - second repo

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.

$ git bundle create commits.bundle master ^9a466c5
Counting objects: 11, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (9/9), 775 bytes, done.
Total 9 (delta 0), reused 0 (delta 0)

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.

$ git bundle verify ../commits.bundle
The bundle contains 1 ref
71b84daaf49abed142a373b6e5c59a22dc6560dc refs/heads/master
The bundle requires these 1 ref
9a466c572fe88b195efd356c3f2bbeccdb504102 second commit
../commits.bundle is okay

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:

$ git bundle verify ../commits-bad.bundle
error: Repository lacks these prerequisite commits:
error: 7011d3d8fc200abe0ad561c011c3852a4b7bbe95 Third commit - second repo

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:

$ git bundle list-heads ../commits.bundle
71b84daaf49abed142a373b6e5c59a22dc6560dc refs/heads/master

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:

$ git fetch ../commits.bundle master:other-master
From ../commits.bundle
 * [new branch]      master     -> other-master

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.

$ git log --oneline --decorate --graph --all
* 8255d41 (HEAD, master) Third commit - first repo
| * 71b84da (other-master) Last commit - second repo
| * c99cf5b Fourth commit - second repo
| * 7011d3d Third commit - second repo
|/
* 9a466c5 Second commit
* b1ec324 First commit

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.