{"id":22441,"date":"2026-01-31T08:34:47","date_gmt":"2026-01-31T07:34:47","guid":{"rendered":"https:\/\/linux-bibel.at\/?p=22441"},"modified":"2026-01-31T08:34:49","modified_gmt":"2026-01-31T07:34:49","slug":"svn-all-fast-export-svn-repositorys-unter-linux-ins-git-konvertieren","status":"publish","type":"post","link":"https:\/\/linux-bibel.at\/index.php\/2026\/01\/31\/svn-all-fast-export-svn-repositorys-unter-linux-ins-git-konvertieren\/","title":{"rendered":"SVN-All-Fast-Export – SVN-Repositorys unter Linux ins Git konvertieren"},"content":{"rendered":"\n

Ich habe letztes Jahr von Git-SVN<\/a> berichtet – mit dieser Software lassen sich SVN-Repositorys ins Git konvertieren, wenn diese nicht zu aufwendig sind! Sobald jedoch eine kleine Schwierigkeit auftritt, hat es sich damit auch schon erledigt.<\/p>\n\n\n\n

Nach kurzer Zeit bin ich auf die Software SVN-All-Fast-Export gesto\u00dfen, sie nennt sich nebenbei auch Svn2Git. Entwickelt wurde die Software von der KDE-Community, um die KDE-Entwicklung damals von SVN auf Git umzustellen. Und – nach einigen sehr umfangreichen und auch umst\u00e4ndlichen SVN-Repos – es funktioniert pr\u00e4chtig.<\/p>\n\n\n\n

SVN-All-Fast-Export installieren<\/h3>\n\n\n\n

Unter auf Debian basierenden Linux-Distributionen installieren Sie diese Software wie \u00fcblich \u00fcber die Paket-Verwaltung durch das Paket „svn-all-fast-export<\/strong>„.<\/p>\n\n\n\n

SVN-All-Fast-Export nutzen<\/h3>\n\n\n\n

Grunds\u00e4tzlich – es ist einfach, auch aufwendige SVN-Repos ins Git zu verschieben, es kostet hin und wieder aber auch Zeit. SVN-All-Fast-Export aberbeitet jedoch um einiges schneller, als Git-SVN – um vieles schneller sogar.<\/p>\n\n\n\n

Grunds\u00e4tzlich ben\u00f6tigen Sie einmal alle Autoren, die im SVN-Repo gearbeitet haben, hierzu clonen Sie sich das Repo am einfachsten auf den lokalen Rechner – also etwa:<\/p>\n\n\n\n

svn co https:\/\/server.org\/svn-repo\/<\/code><\/pre>\n\n\n\n
Sie wechseln auf dem Terminal ins geklonte Verzeichnis und holen sich die Autoren mit folgendem Befehl:<\/p>\n\n\n\n
svn log --xml --quiet | grep author | sort -u | perl -pe 's\/.*>(.*?)<.*\/$1 = \/'<\/code><\/code><\/pre>\n\n\n\n
Je nach Gr\u00f6\u00dfe des Repos kann dies auch einige Minuten dauern – Sie erhalten eine Liste mit Benutzern, ein Beispiel:<\/p>\n\n\n\n
user =\nuser1 =\nuser2 =<\/code><\/pre>\n\n\n\n
Sie kopieren sich diese Liste und f\u00fcgen diese in eine Textdatei ein, diese nenne ich jetzt beispielsweise „authors.txt<\/strong>„. Hier geben Sie den Benutzern eine Git-Vertr\u00e4gliche Namensnennung – beispielsweise:<\/p>\n\n\n\n
user = Benutzer Eins <mail-adresse@.org\nuser1 = Benutzer Zwei <mail-adresse1@org\nuser2 = Benutzer Drei ...\n(no author) = no_author <no_author@no_author><\/code><\/pre>\n\n\n\n
Die letzte Zeile hilft dabei, wenn ein Autor nicht ermittelt werden konnte. Anschlie\u00dfend benennen Sie das Verzeichnis mit dem Repo um – Sie ben\u00f6tigen es noch f\u00fcr die Verzeichnis-Struktur des Repos.<\/p>\n\n\n\n
Jetzt ben\u00f6tigen Sie noch das Original-Verzeichnis des Repos, so wie es auf dem Server liegt – also nicht das eigentliche geklonte Repo, sondern das Verzeichnis mit der Konfiguration des Repos. Ich habe mir dieses meist einfach mit scp auf den lokalen Rechner kopiert – also etwa:<\/p>\n\n\n\n
scp -r root@server.org:\/svn\/repo-verzeichnis\/ \/home\/robert\/svn2git\/<\/code><\/pre>\n\n\n\n
Im Beispiel habe ich jetzt im Verzeichnis „svn2git<\/em>“ das umbenannte, geklonte Repo „repo-umbenannt<\/em>„, das kopierte Repo-Verzeichnis „repo<\/em>“ und die Datei „authors.txt<\/strong>„. Der \u00dcbersicht halber, lege ich jetzt noch ein Verzeichnis namens „git<\/em>“ an – in diesem soll anschlie\u00dfend das konvertierte Git-Repo liegen.<\/p>\n\n\n\n
Was wir jetzt noch ben\u00f6tigen, sind die Regeln, mit denen Svn2Git arbeiten soll. Die Dateiendung daf\u00fcr nennt sich „.rules<\/strong>„, die Textdatei nenne ich jetzt einfach „repo.rules<\/strong>„. In dieser Textdatei beginnen wir damit, die Git-Repo-Namen anzulegen – im Beispiel ist im SVN-Repo nur ein Repo vorhanden, das Repo nenne ich „git-repo<\/strong>„:<\/p>\n\n\n\n
create repository git-repo\nend repository<\/code><\/pre>\n\n\n\n
Sind mehrere SVN-Repos darin vorhanden:<\/p>\n\n\n\n
create repository git-repo\nend repository\ncreate repository zweites-repo\nend repository\n...<\/code><\/pre>\n\n\n\n
Im n\u00e4chsten Abschnitt geben Sie an, was mit den Verzeichnissen im SVN-Repo geschehen soll – ein sehr einfaches SVN-Repo hat folgende Unterverzeichnisse:<\/p>\n\n\n\n
trunk<\/td>Aktuelle Dateien<\/td><\/tr>
tags<\/td>Tags<\/td><\/tr>
branches<\/td>Branches<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Je nach Repo k\u00f6nnen Tags und Branches auch wegfallen, auch k\u00f6nnen sich diese etwas anders nennen, wie es eben erstellt und genutzt wurde. Was mit den Verzeichnissen geschehen soll, geben Sie mit match<\/code> an:<\/p>\n\n\n\n
match \/trunk\/\n  repository git-repo\n  branch master\nend match<\/code><\/pre>\n\n\n\n
Sie geben nicht das Verzeichnis des Repos an, sondern Sie beginnen ab den Unterverzeichnissen. Jetzt gehen Sie weiter mit den vorhandenen Verzeichnissen, um etwa alle Tags und Branches zu \u00fcbernehmen:<\/p>\n\n\n\n
match \/tags\/([^\/]+)\/\n  repository git-repo\n  branch refs\/tags\/\\1\n  substitute branch s\/ \/_\/\nend match\n\nmatch \/branches\/([^\/]+)\/\n  repository git-repo\n  branch refs\/tags\/\\1\n  substitute branch s\/ \/_\/\nend match<\/code><\/pre>\n\n\n\n
Einzelne weitere Verzeichnisse, die im Repo liegen, geben Sie als eigene Repos an – also etwa:<\/p>\n\n\n\n
match \/anderes_Verzeichnis\/\n  repository zweites-repo\n  branch master\nend match<\/code><\/pre>\n\n\n\n
M\u00f6chten Sie Verzeichnisse ausschlie\u00dfen, geben Sie diese wie folgt an:<\/p>\n\n\n\n
match \/auszuschlie\u00dfendes-Verzeichnis\/\nend match<\/code><\/pre>\n\n\n\n
Oder wollen Sie alle nicht angegebenen Verzeichnisse ausschlie\u00dfen:<\/p>\n\n\n\n
match \/\nend match<\/code><\/pre>\n\n\n\n
Manche schwindligen Repos enthalten auch einzelne Dateien, mit solchen gehen Sie ebenso vor. Hin und wieder kann die Software nicht weitermachen, weil Verzeichnisse ausgeschlossen wurden – mit solchen wurden aber vielleicht Tags oder Branches angelegt. In solchen F\u00e4llen schlie\u00dfen Sie diese nicht aus, sondern legen ein extra-Repo an und konvertieren diese einfach in ein solches – Svn2Git holt sich diese dann, wie sie gebraucht werden.<\/p>\n\n\n\n
Haben Sie die Regeln erstellt, wechseln Sie in das neu angelegte Verzeichnis – ich habe es, wie oben beschrieben „git<\/em>“ genannt. Dort wird die Konvertierung auf dem Terminal gestartet (nach dem Beispiel oben<\/em>):<\/p>\n\n\n\n
svn-all-fast-export --identity-map=..\/authors.txt --rules=..\/repo.rules --stats --add-metadata \/home\/robert\/svn2git\/repo\/<\/code><\/pre>\n\n\n\n
Mit --identity-map=<\/code> geben Sie die Autoren-Datei an, mit --rules=<\/code> die Regel-Datei. Zuletzt folgt das vom Server kopierte Verzeichnis, nicht das geklonte. Sie k\u00f6nnen auch Revisionen ausschlie\u00dfen – dies gelingt mit der Textdatei „rev.txt<\/strong>“ im Verzeichnis mit den Regeln – hier geben Sie an, welche Revisionen konvertiert werden sollen,ein Beispiel:<\/p>\n\n\n\n
0-10\n12-200\n210-230<\/code><\/pre>\n\n\n\n
Im Befehl geben Sie diese wie folgt an:<\/p>\n\n\n\n
--revisions-file=..\/rev.txt<\/code><\/pre>\n\n\n\n
Die Software beginnt zu konvertieren und l\u00e4sst Sie mitsehen, was gerade geschieht, zeigt am Ende das Log. Zuletzt zeigt die Software alle von Ihnen angegebenen Verzeichnisse – dahinter eine Zahl mit den Treffern. Ist hier eine Zahl bei Null, konnte die Software damit nichts anfangen und Sie haben eine fehlerhafte oder keine Konvertierung. Scollen Sie \u00fcber die Verzeichnisse – dort finden Sie in den letzten zwei Zeilen die Fehlermeldung, meist handelt es sich um nicht angegebene Verzeichnisse, weil diese etwa gel\u00f6scht oder umbenannt wurden. Geben Sie an, was damit geschehen soll und starten erneut, bis Sie keine Fehlermeldungen mehr vorfinden. Im Verzeichnis, in dem Sie den Befehl gestartet haben, finden Sie anschlie\u00dfend die Verzeichnisse mit den erstellten Git-Repos.<\/p>\n\n\n\n
In diese Verzeichnisse k\u00f6nnen Sie nun wechseln und schon einmal testen:<\/p>\n\n\n\n
git log\ngit tag\ngit branch<\/code><\/pre>\n\n\n\n
Erhalten Sie eine Fehlermeldung, sehen Sie sich wieder die Logs an, Sie haben vergessen eines oder mehrere Verzeichnisse anzugeben.<\/p>\n\n\n\n
Ist die Konvertierung gelungen – und dies tut sie irgendwann, legen Sie im Git die neues Repos an und schupfen die einzelnen Repos, deren Tags und Branches ins Git. Sie haben dann dort die komplette History, die Tags und Branches.<\/p>\n\n\n\n
Wichtig vor allem – SVN erlaubt auch etwa einen Trunk unter einem Trunk – Git tut dies nicht, einen Trunk unter einem Trunk, m\u00fcssen Sie als eigenes Git-Repo konvertieren.<\/p>\n\n\n\n
Svn2Git funktioniert perfekt und mehr als doppelt so schnell, wie Git-SVN.<\/p>\n
\r\n    
\r\n    \r\n                            \"Gef\u00e4llt\r\n            <\/a>\r\n    4    <\/span>\r\n<\/div>
\r\n    \r\n                            \"Gef\u00e4llt\r\n            <\/a>\r\n    <\/span>\r\n<\/div><\/div>","protected":false},"excerpt":{"rendered":"
Ich habe letztes Jahr von Git-SVN berichtet – mit dieser Software lassen sich SVN-Repositorys ins Git konvertieren, wenn diese nicht zu aufwendig sind! Sobald jedoch eine kleine Schwierigkeit auftritt, hat es sich damit auch schon erledigt. Nach kurzer Zeit bin ich auf die Software SVN-All-Fast-Export gesto\u00dfen, sie nennt sich nebenbei auch Svn2Git. Entwickelt wurde die […]<\/p>\n","protected":false},"author":1,"featured_media":22442,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[48],"tags":[49],"class_list":["post-22441","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-entwicklung","tag-entwicklung"],"_links":{"self":[{"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/posts\/22441","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/comments?post=22441"}],"version-history":[{"count":1,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/posts\/22441\/revisions"}],"predecessor-version":[{"id":22443,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/posts\/22441\/revisions\/22443"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/media\/22442"}],"wp:attachment":[{"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/media?parent=22441"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/categories?post=22441"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/tags?post=22441"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}