Chapters ▾ 2nd Edition

7.12 Git Tools - Bundling

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 <schacon@gmail.com>
Date:   Wed Mar 10 07:34:10 2010 -0800

    Second commit

commit b1ec3248f39900d2a406049d762aa68e9641be25
Author: Scott Chacon <schacon@gmail.com>
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.