Übersicht

git bundle create <file> <git-rev-list-args>
git bundle verify <file>
git bundle list-heads <file>
git clone <file> <dir>

Beschreibung

Der git bundle-Befehl verpackt Git-Historie in eine einzelne Datei, die ohne Netzwerk übertragen werden kann — per USB-Stick, E-Mail oder beliebigem Datei-Transport. Der Empfänger kann vom Bundle aus klonen oder fetchen, als wäre es ein Remote. Das ist unschätzbar für Air-Gapped-Systeme, langsame Verbindungen oder als Backup-Format.

Bundles unterstützen inkrementelle Updates: Schließen Sie eine Basis-Ref ein, sodass das Bundle nur Commits seit dieser Ref enthält, und lassen Sie den Empfänger es mit git fetch auf einem bestehenden Repo anwenden.

Im täglichen Einsatz integriert sich git bundle eng mit Shell-Aliasen, Editor-Plugins und Continuous Integration. Power-User fügen oft Aliase hinzu, die Flags kombinieren, die sie immer übergeben, oder wickeln den Befehl in Skripte, die Teamkonventionen durchsetzen. Die Ausgabeformatierung kann über Git-Config angepasst werden — Pretty-Formate, Farbschemata und Pager-Verhalten sind alle einstellbar. Wenn etwas schiefgeht, ist der erste Diagnoseschritt üblicherweise, den Befehl erneut mit GIT_TRACE=1 in der Umgebung auszuführen, was die zugrunde liegenden Plumbing-Aufrufe offenlegt. Für ungewöhnliche Situationen öffnet die --help-Ausgabe (git bundle --help) die vollständige Manpage mit Details zu jeder Option, einschließlich solcher, die in alltäglichen Workflows selten verwendet werden, aber für Debugging oder Skripting im großen Maßstab essentiell sind.

Zu verstehen, wie git bundle mit dem Rest von Gits Datenmodell interagiert — der Objektdatenbank, dem Index, Refs und dem Working Tree — zahlt sich aus. Jeder Befehl operiert auf einer Teilmenge dieser Stücke, und zu wissen, welche er berührt, hilft Ergebnisse vorherzusagen und sich von Fehlern zu erholen. Das Lesen der offiziellen Git-Dokumentation neben praktischer Übung in einem Wegwerf-Repository ist der schnellste Weg, die Nuancen zu verinnerlichen. Die meisten Produktionsprobleme mit Git rühren von einer von drei Ursachen: überraschendem Standardverhalten, partiellen Netzwerkoperationen oder dem Umschreiben bereits geteilter Historie. Ein funktionierendes mentales Modell der Nebenwirkungen von git bundle hilft, alle drei zu vermeiden.

Häufige Optionen

Unterbefehl	Beschreibung
create <file> <refs>	Erstellt eine Bundle-Datei.
verify <file>	Prüft, ob ein Bundle gültig und anwendbar ist.
list-heads <file>	Listet die im Bundle enthaltenen Refs auf.
unbundle <file>	Plumbing: gibt Objekte ans Repository aus.
--all	Bezieht alle Refs ein.
--progress	Zeigt Fortschritt bei der Erstellung.

Beispiele

git bundle create repo.bundle --all
    # Vollständiges Backup jeder Ref

    git bundle create incremental.bundle main ^v2.0
    # Nur Commits auf main seit v2.0

    git bundle verify repo.bundle
    # Anwendbarkeit vor dem Fetchen prüfen

    # Auf der Empfängerseite:
    git clone repo.bundle myproj
    # oder in ein bestehendes Repo:
    git fetch ../incremental.bundle main:main

Häufige Fehler

Ein Bundle ohne Basisangabe zu erstellen bedeutet, dass der Empfänger jedes Mal die volle Historie bekommt, auch für kleine Updates. Verwenden Sie Bereiche wie --since oder ^<ref> für inkrementelle Bundles. git bundle verify gegen ein leeres Repo prüft nur strukturelle Gültigkeit, nicht ob die Voraussetzungen des Bundles vorhanden sind.

Verwandte Befehle

git archive, git fetch, git clone, git pack-objects