{"id":808,"date":"2012-06-24T13:37:17","date_gmt":"2012-06-24T11:37:17","guid":{"rendered":"http:\/\/blog.speedyj.de\/?p=808"},"modified":"2014-07-08T21:35:39","modified_gmt":"2014-07-08T19:35:39","slug":"svn-repos-auf-eigenen-git-server-migrieren","status":"publish","type":"post","link":"https:\/\/blog.speedyj.de\/?p=808","title":{"rendered":"SVN-Repos auf eigenen Git Server migrieren"},"content":{"rendered":"

Vor einer Weile hatte hatte ich mir einen SVN Server mittels WAMP<\/a> zusammengebastelt. Die L\u00f6sung l\u00e4uft bei mir aktuell immer noch, obwohl ich schon seit einer Weile auf lokale GIT Repositories gewechselt bin<\/a>. Das hat es mir erm\u00f6glicht, jederzeit und unterwegs mit dem Repository zu arbeiten, also Verlauf einsehen und \u00c4nderungen einchecken, und sobald ich wieder netzwerktechnisch auf mein SVN zugreifen konnte, wurden die durchgef\u00fchrten Commits einfach ins SVN \u00fcbertragen. Den SVN-Server durch einen GIT „Server“ zu ersetzen, war mir bisher zu aufwendig.<\/p>\n

Die Tage bin ich dann \u00fcber gitblit<\/a> gestolpert. Dabei handelt es sich um ein Tool, in dem man einfach seine GIT Repositories hosten und auch f\u00fcr andere zug\u00e4nglich machen kann. Das ganze kommt mit einem \u00fcbersichtlichen Webfrontend daher, kurz gesagt: scheinbar ein perfekter Ersatz f\u00fcr meinen SVN Server.<\/p>\n

Installation<\/strong><\/p>\n

gitblit gibt es in verschiedenen Download-Varianten. Die „GO“ Variant beinhaltet alles was man braucht um direkt loszulegen, kommt dabei „aber“ mit einem eigenen Jetty Webserver daher. Da ich eher einen lokalen Tomcat verwenden m\u00f6chte, habe ich mir einfach die WAR-Datei (Web Archive) heruntergeladen.<\/p>\n

Der Tomcat liegt bei mir unter D:\\temp\\apache-tomcat-7.0.28, d.h. die WAR-Datei wird in das Unterverzeichnis „webapps\\gitblit“ entpackt. \u00c4nderungen an den Einstellungen habe ich f\u00fcr meinen Test keine vorgenommen. Die vollst\u00e4ndige Einrichtung erledige ich wenn ich genug getestet habe. Zum Abschluss sollte man pr\u00fcfen, ob der Tomcat auch gestartet ist.<\/p>\n

Tja, das war es eigentlich auch schon. Wenn man jetzt im Webbrowser die Adresse http:\/\/localhost:8080\/gitblit\/ aufruft, bekommt man folgende Seite zu Gesicht.<\/p>\n

\"\"<\/a>Erste Schritte<\/strong><\/p>\n

F\u00fcr die Verwaltung der Repositories muss man sich anmelden. Einfach oben rechts mit Benutzer admin und Passwort admin anmelden. Jetzt bekommt man zus\u00e4tzliche Navigationspunkte und Funktionen angezeigt.<\/p>\n

\"\"<\/a><\/p>\n

Etwa rechts in der Mitte (also oberhalb der leeren Repository-Liste) hat man die M\u00f6glichkeit ein neues Repository anzulegen. Mit einem Klick auf „new repository“ gelangt man zu einer Seite mit vielen Einstellungen. Ich gebe nur ins erste Feld den Name „test“ ein und klicke ganz unten auf „Save“. Damit habe ich ein neues Repository angelegt und das wird jetzt in der \u00dcbersicht als leer angezeigt. Jetzt muss man seinem lokalen Git-Repository nur noch den neuen Remote-Server mitteilen, und schon kann man mittels Push das Repo auf den Server \u00fcbertragen. Die notwendigen Schritte\/Befehle werden direkt im gitblit-Frontend angezeigt. Einfacher geht es nicht.<\/p>\n

SVN Migration<\/strong><\/p>\n

Als n\u00e4chstes m\u00f6chte ich eines meiner SVN-Repositories in das eben erstellte importieren. Das gestaltet sich nicht ganz so einfach, da man mehrere Dinge beachten sollte:<\/p>\n

    \n
  1. Man ben\u00f6tigt ein Author-Mapping, damit die Namen aus dem SVN-Repository nicht verloren gehen<\/li>\n
  2. Alle SVN-Branches m\u00fcssen in Git als Branch angelegt werden<\/li>\n
  3. Alle SVN-Tags m\u00fcssen in Git angelegt werden<\/li>\n<\/ol>\n

    Zum Gl\u00fcck muss ich mir nicht alles selbst zusammensuchen und kann auf Hilfe auf dem Internet<\/a> zugreifen. S\u00e4mtliche nun folgenden Arbeiten f\u00fchre ich in der „Git Bash“ aus, die man ja eigentlich intstalliert hat, wenn man mit Git unter Windows arbeitet. Wenn nicht, dann msysGit<\/a> installieren.<\/p>\n

    Author Mapping<\/strong><\/p>\n

    Um \u00fcberhaupt an die eine Liste der Authoren heranzukommen, greift man am Besten auf ein kleines Bash-Script zur\u00fcck. Das in Sven’s Blog<\/a> bereitgestellte Skript, musste ich leicht anpassen, da es a) mit Leerzeichen in Authoren nicht klar kam und b) ein lokales SVN-Repository ben\u00f6tigte. An die ge\u00e4nderte Version kann ich einfach eine URL zum SVN-Server \u00fcbergeben und schon bekomme ich eine Liste der Authoren. Hier das ge\u00e4nderte Script „svn_author_export.sh“ (Download weiter unten):<\/p>\n

    #!\/bin\/bash<\/span>\r\nIFS=$(echo -en \"\\n\\b\")<\/span>\r\nauthors=$(svn log -q $1 | grep -e '^r' | awk 'BEGIN { FS = \"|\" } ; { print $2 }' | sort | uniq)<\/span>\r\nfor author in ${authors}; do<\/span>\r\n\u00a0 echo \"${author} = ${author} <${author}@domain.com>\" >> svn.authors ;<\/span>\r\ndone<\/span><\/pre>\n
    Der Aufruf sieht dann wie folgt aus:<\/p>\n
    .\/svn_author_export.sh http:\/\/localhost\/svn\/svnGitTest<\/span><\/pre>\n
    Im lokalen Verzeichnis gibt es nach dem Ausf\u00fchren eine Datei namens „svn.authors“, die man jetzt entsprechend anpassen sollte.<\/p>\n
    SVN Repository clonen<\/strong><\/p>\n
    Das eben erstellte Author-Mapping kommt beim Clonen des SVN-Repositories zum Einsatz.<\/p>\n
    git svn --authors-file=.\/svn.authors clone -s http:\/\/localhost\/svn\/svnGitTest<\/span><\/pre>\n
    Jetzt hat man ein lokales Git-Repository mit s\u00e4mtlichen Commits aus dem SVN und den entsprechend gemappten Author-Namen\/Emailadressen. Das kann man durch einen Blick ins „git log“ \u00fcberpr\u00fcfen.<\/p>\n
    Repository migrieren<\/strong><\/p>\n
    Nachdem man das SVN-Repository nach Git geclont hat, sind einige Aufr\u00e4umarbeiten notwendig. So muss man f\u00fcr jede SVN-Branch auch eine lokale Git-Branch erstellen, und auch die Tags aus dem SVN korrekt \u00fcbernehmen. Um diesen Schritt zu automatisieren habe ich ein kleines Script gebastelt (Download weiter unten):<\/p>\n
    #!\/bin\/bash<\/span>\r\nbranches=$(git branch -a | grep -e ' remotes\/' | awk -F: '{print substr($0, 3)}')<\/span>\r\nfor branch in ${branches}; do<\/span>\r\n\u00a0 tagName=$(expr \"$branch\" : \"remotes\/tags\/\\(.*\\)\")<\/span>\r\n\u00a0 branchName=$(expr \"$branch\" : \"remotes\/\\(.*\\)\")<\/span>\r\n\u00a0 if [ -n \"$tagName\" ]; then<\/span>\r\n\u00a0\u00a0\u00a0 git checkout -b tag_\"$tagName\" remotes\/tags\/$tagName<\/span>\r\n\u00a0\u00a0\u00a0 git tag $tagName tag_\"$tagName\"<\/span>\r\n\u00a0\u00a0 \u00a0git checkout master<\/span>\r\n\u00a0\u00a0 \u00a0git branch -D tag_\"$tagName\"<\/span>\r\n\u00a0\u00a0 \u00a0git branch -D -r tags\/$tagName<\/span>\r\n\u00a0 else <\/span>\r\n\u00a0\u00a0\u00a0 if [ \"$branchName\" != \"trunk\" ]; then<\/span>\r\n\u00a0\u00a0\u00a0\u00a0\u00a0 git checkout -b $branchName remotes\/$branchName<\/span>\r\n\u00a0\u00a0 \u00a0fi<\/span>\r\n\u00a0\u00a0 \u00a0git checkout master<\/span>\r\n\u00a0\u00a0 \u00a0git branch -D -r $branchName<\/span>\r\n\u00a0 fi<\/span>\r\ndone<\/span><\/pre>\n
    Ok, was passiert in diesem Script?<\/p>\n
      \n
    1. Zun\u00e4chst werden alle Remote-Branches ermittelt<\/li>\n
    2. Dann wird unterschieden, ob es sich um einen Tag oder eine echte Branch handelt<\/li>\n
    3. Bei Tags wird tempor\u00e4r eine Branch (basierend auf dem Remote-Tag) angelegt und darauf ein entsprechender Tag erzeugt.<\/li>\n
    4. Bei Branches wird einfach eine entsprechende Branch angelegt (au\u00dfer f\u00fcr die Remote-Branch „remotes\/trunk“)<\/li>\n
    5. … und nebenbei werden alle Remote-Branches gel\u00f6scht, also das Repository vom SVN abgekoppelt.<\/li>\n<\/ol>\n
      Jetzt sollte man genau pr\u00fcfen, ob irgendwelche Fehler aufgetreten sind. Falls etwas schief gegangen ist, hilft es meist nur,\u00a0 das gesamte Repository frisch aus dem SVN zu clonen (oder man hat sich vorher ein Backup vom Verzeichnis gemacht). Ggf. sollte man den 5ten Schritt weglassen, wenn man sein SVN- und den Git-Server parallel laufen und Commits zwischen beiden syncronisieren lassen m\u00f6chte.<\/p>\n
      Auf den Server \u00fcbertragen<\/strong><\/p>\n
      Nun ist es an der Zeit unser Repository auf den Server zu \u00fcbertragen. Dazu m\u00fcssen wir unserem lokalen Git-Repository erstmal ein neues Remote mitteilen und dann unsere Branches und Tags pushen.<\/p>\n
      git remote add gitblit http:\/\/localhost:8080\/gitblit\/git\/svnGitTest.git<\/span>\r\ngit push gitblit master work_test work_new work_experimental first_tag<\/span><\/pre>\n
      Das kann nat\u00fcrlich wieder aufw\u00e4ndig werden, wenn man sehr viele Branches\/Tags hat. Daf\u00fcr kann man aber auch ein kleines Script (commit_all_branches_and_tags.sh) benutzen.<\/p>\n
      \"\"<\/a><\/p>\n
      Wie man sieht, ermittelt das Script selbstst\u00e4ndig alle Branches und Tags und puscht diese an das Remote mit dem Namen „gitblit“. Wenn ein anderer Name f\u00fcr den Remote verwendet wurde, dann kann man den Namen einfach als ersten Parameter an das Script \u00fcbergeben. Hier noch das Script (Download weiter unten):<\/p>\n
      #!\/bin\/bash<\/span>\r\nremote=\"gitblit\"<\/span>\r\nif [ -n \"$1\" ]; then<\/span>\r\n\u00a0 remote=$1<\/span>\r\nfi<\/span>\r\nbranches=$(git branch | awk -F: '{print substr($0, 3)}')<\/span>\r\ntags=$(git tag)<\/span>\r\nentries=\"${branches} ${tags}\"<\/span>\r\nentries=${entries[*]}<\/span>\r\necho \"Committing: ${entries}\" <\/span>\r\ngit push ${remote} ${entries}<\/span><\/pre>\n
      Jetzt kann man sich auch das Ergebnis im Webfrontend anschauen oder sich das Repository auf einen anderen Rechner clonen.<\/p>\n
      \"\"<\/a><\/p>\n
      Zusammenfassung<\/strong><\/p>\n
      Auch wenn das Migrieren im ersten Moment doch etwas aufw\u00e4ndig erscheint, kann man mit wenigen Handgriffen oder durch die Verwendung von Scripts recht schnell zum Ziel gelangen. Grad der in die Scripte gesteckte Aufwand wird sich bei der Migration der weiteren Repositories auszahlen. Ob man bei der Migration gitblit oder eine andere L\u00f6sung aufbaut — in beiden F\u00e4llen kann ich hier wieder auf die Scripte und Vorgehensweise zur\u00fcckgreifen.<\/p>\n
      Eine kleine \u00c4nderung an der Konfiguration von gitblit musste ich dann doch vornehmen. Bei Branches und Tags wurde im Webfrontend nur eine leere Seite angezeigt. Das Problem ist aber bekannt <\/a>und kann (in des Dateien reference.properties und web.xml) durch das Setzen von „web.mountParameters“ auf „false“ beseitigt werden.<\/p>\n
      Die restlichen Funktionen von gitblit muss ich jetzt nach und nach ausprobieren. Aber mein SVN-Server wird wohl bald ausgediehnt haben.<\/p>\n
      Links<\/strong>
      \n      Gitblit-Homepage<\/a>
      \n      SVN to Git Migration von Sven Goethel<\/a>
      \n      Download der Scripte<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
      Vor einer Weile hatte hatte ich mir einen SVN Server mittels WAMP zusammengebastelt. Die L\u00f6sung l\u00e4uft bei mir aktuell immer noch, obwohl ich schon seit einer Weile auf lokale GIT Repositories gewechselt bin. Das hat es mir erm\u00f6glicht, jederzeit und unterwegs mit dem Repository zu arbeiten, also Verlauf einsehen und \u00c4nderungen einchecken, und sobald ich […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6,9],"tags":[35,36,37],"class_list":["post-808","post","type-post","status-publish","format-standard","hentry","category-software","category-tools","tag-git","tag-gitblit","tag-svn"],"_links":{"self":[{"href":"https:\/\/blog.speedyj.de\/index.php?rest_route=\/wp\/v2\/posts\/808","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.speedyj.de\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.speedyj.de\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.speedyj.de\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.speedyj.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=808"}],"version-history":[{"count":22,"href":"https:\/\/blog.speedyj.de\/index.php?rest_route=\/wp\/v2\/posts\/808\/revisions"}],"predecessor-version":[{"id":1054,"href":"https:\/\/blog.speedyj.de\/index.php?rest_route=\/wp\/v2\/posts\/808\/revisions\/1054"}],"wp:attachment":[{"href":"https:\/\/blog.speedyj.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=808"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.speedyj.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=808"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.speedyj.de\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=808"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}