In der Welt der Softwareentwicklung sind Versionskontrollsysteme unverzichtbar, wobei Git als eines der beliebtesten Tools zur Verwaltung von Quellcode gilt. Häufig entsteht jedoch die Herausforderung, Dateien oder ganze Ordner samt ihrer kompletten Historie von einem Repository in ein anderes zu übertragen. Dabei ist es wichtig, nicht nur den aktuellen Stand der Daten zu verschieben, sondern auch die gesamte Änderungshistorie zu erhalten, um nachvollziehbar zu bleiben, wie und wann bestimmte Entwicklungen stattgefunden haben. Die Problematik ist dabei durchaus komplex, denn eine simple Kopie der Dateistruktur genügt selten – historische Daten gehen ohne geeignete Maßnahmen verloren. Traditionell war git filter-branch ein gängiges Werkzeug, um solche Aufgaben zu bewältigen.
Allerdings hat sich dieser Ansatz aufgrund seiner Komplexität und möglicher Probleme mit der Historienbereinigung als wenig praktikabel erwiesen. Die Git-Community rät heute zur Verwendung von filter-repo, einem ausgeklügelten und für den Nutzer deutlich komfortableren Werkzeug, das separat installiert werden muss, aber erheblich bessere Ergebnisse liefert. Das Verschieben von Dateien mit voller Historie unter Verwendung von filter-repo beginnt mit einer Phase der Bereinigung im Quellrepository. Dabei wird in einer neuen lokalen Branch gearbeitet, um keine unerwünschten Auswirkungen auf den Hauptzweig zu riskieren. Mit Hilfe des filter-repo-Befehls lassen sich gezielt nur diejenigen Pfade auswählen, die in das Zielrepository übertragen werden sollen, während alle anderen ausgeklammert werden.
So entsteht eine schlanke Historie, die ausschließlich die gewünschten Dateien und Ordner umfasst. Sobald die Bereinigung abgeschlossen ist, bewegt sich der Entwickler ins Zielrepository. Dort wird das Quellrepository als Remote hinzugefügt – eine Methode, die eine Brücke zwischen den Repositories herstellt, ohne dass Daten manuell kopiert werden müssen. Mithilfe von Git-Befehlen wird dann die bereinigte Historie vom Quell- in das Zielrepository heruntergeladen und in einem separaten Branch bereitgestellt. Im nächsten Schritt verschmilzt der Entwickler diese Historie mit dem Hauptzweig des Zielrepositories.
Da es sich um zwei unabhängig entstandene Repositories handelt, ist die Verwendung der Option "--allow-unrelated-histories" essenziell, um Konflikte beim Merge-Prozess zu vermeiden. Nach erfolgreicher Zusammenführung folgen Aufräumarbeiten, in deren Rahmen das temporär hinzugefügte Remote und die zusätzlichen Branches entfernt werden, um die Umgebung sauber zu hinterlassen. Auf diese Weise wird gewährleistet, dass das Zielrepository die Dateien inklusive ihrer kompletten Änderungshistorie enthält, ohne überflüssigen Ballast oder Konflikte zu hinterlassen. Ein wichtiger Aspekt für Entwickler ist die Installation von filter-repo, da dieses Tool nicht in der Standard-Git-Distribution enthalten ist. Abhängig vom Betriebssystem stehen verschiedene Paketmanager zur Verfügung, die eine unkomplizierte Integration ermöglichen.
Unter Windows kann die Installation etwas komplexer ausfallen, deshalb lohnt sich ein Blick in die offiziellen Anleitungen im GitHub-Repository von filter-repo. Nach der Installation steht filter-repo als ein Git-Subbefehl zur Verfügung, was die Handhabung und Einbindung in bestehende Workflows sehr komfortabel macht. Die Nutzung von filter-repo bietet gegenüber alternativen Methoden wie Patch-Erstellung oder filter-branch einige entscheidende Vorteile. Sie gestaltet den Prozess nicht nur benutzerfreundlicher, sondern erhöht auch die Zuverlässigkeit und Qualität der resultierenden Historie. Insbesondere bei größeren Projekten oder solchen mit langer Entwicklungshistorie spielt dies eine wichtige Rolle, um die Integrität der Versionskontrolle zu bewahren.
Für Teams, die ihre Codebasis reorganisieren oder bestimmte Komponenten aus einem Monorepo auslagern möchten, stellt diese Methode eine elegante Lösung dar. Sie sorgt dafür, dass nachvollziehbar bleibt, wer wann welche Änderung an welchem Teil des Codes vorgenommen hat – ein entscheidender Faktor für Wartbarkeit und Compliance. Neben dem technischen Wissen sind ein paar bewährte Vorgehensweisen zu empfehlen. Beispielsweise sollte die Anwendung der Änderungen zunächst immer in einer separaten Branch erfolgen, um etwaige Fehler isoliert korrigieren zu können. Das strukturelle Verständnis des Quellrepositorys ist ebenfalls hilfreich, um richtige Pfade für die Filterbefehle zu bestimmen, damit nicht versehentlich wichtige Dateien übersehen oder zuviel mitgenommen werden.
Insgesamt stellt die Kombination aus filter-repo und den klassischen Git-Kommandos mittlerweile den Goldstandard in der Aufgabe dar, Dateien mit Geschichte zwischen Repositories zu transferieren. Die hohe Flexibilität erlaubt es, nahezu beliebige Strukturen abzubilden und den Vorgang damit an die spezifischen Bedürfnisse einzelner Projekte anzupassen. Somit erleichtert diese Technik Entwicklungsprozesse erheblich und trägt dazu bei, den Code und seine Historie sauber und nachvollziehbar zu halten. Entwickler, die sich dieser Methode bedienen, können sich sicher sein, dass sie ihre Repositories effizient verwalten – auch bei komplexen Anforderungen wie dem Verschieben von Dateien über Repos hinweg.
