Tutorial + Blog Post: Migrating SVN to GitLab

We would like a simple tutorial that we can make into a blog post and update our docs on the basics of migrating from SVN to GitLab.

Current docs: http://doc.gitlab.com/ce/workflow/importing/migrating_from_svn.html


Objective

  • Migrate from SVN Repository to GitLab
  • Help the user to convert the commit history of his SVN Repository to Git using svn2git
  • Additional(?): Use Docker for svn2git (no need to install svn2git and its dependencies)

Outline

Introduction

  • What is covered by this tutorial
  • Motivation to migrate to SVN

Getting Started (Install requirements)

  • Install svn2git(+ Dependencies, git, etc.), or
  • use the pre-configured Docker image (?)

Map the authors

  • Extract the SVN usernames from the SVN history
  • Create a map file for git with names and e-mail addresses

Convert the repository with svn2git

  • Step-by-Step convert for the most common SVN setup(s)

Push to GitLab

  • Create target project on GitLab
  • Push the Git repository to GitLab