Migrating SVN subproject to GitHub
Suppose you have SVN repo that consists of a number of subprojects. And you want to extract one of them and convert it into a valid Git repo in order to load it to GitHub.
- SVN repo at path
- Each SVN subproject has following structure:
trunk/ tags/ branches/.
- svn and git tools installed.
- Also you will need svn2git tool. It depends on git, git-svn and ruby, so make sure you’ve got them before installing svn2git.
First, we will need to do whole dump of svnrepo:
Then, we will filter that dumpfile through
svndumpfilter in order to exclude all subdirs except for
A couple of useful command-line arguments:
- –drop-empty-revs - if SVN repo holds several subprojects there will be revisions when no file which belong to current subproject is affected at all, i.e. empty revisions. If you don’t want to have them in your extracted repo, this parameter would just skip them during extracting.
- –renumber-revs - in case some of revisions was dropped, there will be gaps in revision numbers. This paramter would renumber revisions so there will be no gaps in numbers.
NOTE: if this subproject was named otherwise once and than later had been renamed to
subproject, you must include that one too! Of course, if it had been renamed twice, you will need both old names to include and so on.
Preparing for conversion
Now we have a correct SVN repo dump so we could restore it as an actual SVN repo. Though, it’s structure is a bit complicated:
That is, there is a dir named
subproject in the repo’s root. In order to successfully convert it to Git repo with tags and branches converted from file (as in SVN) to actual tags and branches (as in Git), you might want to change repo structure to following one:
To make it look like above, you need manually edit subproject dump file and change each
Node-copyfrom-path be removing all heading “subproject” components. Also, you might want to remove the actual “subproject” dir creation (usually it can be found in the very first revision).
Restoring SVN repo
As simple as it is:
You can now ensure that repository was restored correct by listing it’s content:
Converting to Git repo
svn2git utility makes a Git repo in current working directory, so create some empty dir and cd to it:
svn2git by default will look for tags, branches and trunk dirs, converting them to the actual tags, branches and master branch respectively, so make sure that SVN repo has them on it’s top level.
If you want to change authors’ names, create conversion file for them somewhere with content like:
And then pass this file to svn2git:
Pushing repo to GitHub
- Create a repo on GitHub.
- Add a remote for the repo: