<h1>Let GitHub do it for you</h1>
<p>GitHub can directly import <span class="caps">SVN</span> projects. All you’ll need is the repository <span class="caps">URL</span>. More details are in the <a href="http://github.com/blog/156-subversion-importing">blog article</a> that introduced the feature. Note: GitHub does not keep imported projects synchronized with the <span class="caps">SVN</span> repo.</p>
<h1>Do it yourself</h1>
<h2>svn2git</h2>
<p><a href="http://github.com/nirvdrum/svn2git">svn2git</a> is designed to provide a complete svn import. Unlike git-svn, it will create proper git tags from your svn “tags”. Note: The current version of svn2git has GitHub support removed.</p>
<h2>git-svn</h2>
<p><a href="http://www.kernel.org/pub/software/scm/git/docs/git-svn.html">git-svn</a> can be used to import as well. Note that there may be issues if you have branches or tags (they won’t be imported over). If you only have a trunk, like many svn repositories, this method should work for you without issue.</p>
<p>First, be sure to <a href="http://github.com/repositories/new">create your repository on github</a></p>
<pre class="console"> $ git svn clone -s SVN_REPO_URL LOCAL_DIR
$ cd LOCAL_DIR
$ git remote add origin git@github.com:GITHUB_USERNAME/REPO_NAME.git
$ git push origin master</pre>
<p>Note that the -s switch implies that your svn repo is set up with the standard branches / tags / trunk structure.</p>
<p>git-svn adds a note to every commit message it copies over from svn. To get rid of that note, add <code>--no-metadata</code> to the git svn clone command</p>
<p>You can pull in later commits by running <code>git-svn rebase</code> from within your repo. (If you ever lose your local copy, just run the import again with the same settings, and you’ll get another working directory with all the necessary <span class="caps">SVN</span> metainfo.).</p>
<h3>Author mapping</h3>
<p>When migrating a Subversion repository to Git, you can map the Subversion users to Git users. You have to create an authors file which contains the mappings:<br />
<pre>fesplugas = Francesc Esplugas <fesplugas@intra….bles.net></pre></p>
<p>Then clone the subversion repository with the previously created <code>authors-file</code>:<br />
<pre class="console">$ git svn —authors-file=/home/fesplugas/.authors clone svn://intraducibles.net/var/svn/rails/plugins/something_fu something_fu</pre></p>
<h2>Other guides</h2>
<ul>
<li><a href="http://www.simplisticcomplexity.com/2008/03/05/cleanly-migrate-your-subversion-repository-to-a-git-repository/">Guide by Jon Maddox</a> (doesn’t deal with branches)</li>
<li><a href="http://www.fnokd.com/2008/08/20/mirroring-svn-repository-to-github">Guide by Bob McWhirter</a> (doesn’t deal with branches)</li>
<li><a href="http://blog.woobling.org/2009/06/git-svn-abandon.html">Guide by Yuval Kogman</a></li>
</ul>
2008-02-15T14:36:04-08:00
11
import-from-subversion
Import from Subversion
2009-10-25T16:48:04-07:00
5364