从SVN迁移代码到Git实践总结

前言

在Git流行起来之前,SVN是一个比较火爆的集中式的版本控制工具。但是Git作为分布式的版本控制工具,它在管理、使用等方面都比SVN要好,越来越多的公司、开发人员开始使用Git来替代SVN。这就涉及到历史代码迁移问题。当然最原始的方法就是把代码手动下载下来,然后手动创建Git仓库,再把代码push上去。这样做不仅耗费时间而且对于一些有用的信息如:原先SVN中的commit纪录等就没有了。今天借着迁移部门之前系统代码的机会,对整个过程进行总结。

需要了解的背景知识

由于之前一直使用的是Git,没有接触过SVN,所以对于SVN并不是很了解,尤其是一些基础的术语的了解。也正是因为这个原因让我在往Git上迁移代码的时候遇到了一些麻烦,甚至一度卡在那里,不知道该怎么办了。

  • 下面简单介绍一下SVN以及一些基础的术语:

    SVN的基本工作原理是在一台服务器上建立一个代码仓库,在这个仓库里面可以存放不同项目的源代码,每个用户、开发人员在使用代码仓库之前需要先把代码仓库里面的代码下载到本地(Checkout),然后用户可以在本地对代码进行修改,最后用svn命令进行提交(Commit)。整个流程跟Git的使用相差不多,只是使用的命令不同。其中刚刚介绍的创建代码仓库的服务器称为SVN服务器,用户、开发人员使用SVN客户端与SVN服务器进行交互。

    • SVN服务器:一般分为两大种类,一类是独立的服务器,它使用SVN协议,另一类的是借助Apache服务器来实现的,它使用HTTP协议
    • SVN客户端:一般分为命令行和图形化工具两大类,常用的图形化工具有TortoiseSVN
  • SVN基本命令:

    • 服务器端(管理员使用的):svnadmin、 svnserve

    • 客户端(开发人员使用的):svn

  • SVN目录

    • /trunk:开发主线,相当于Git中的Master分支。

    • /branches:支线副本,相当于Git中的其余分支。

    • /tags:标签,与Git中的标签一样。

    一般的所有的开发工作都是基于trunk进行的,当一个版本开发完成,或者开发到一定段落(开发、测试、文档、制作安装程序、打包等结束后),代码基本上就处于一个稳定的状态,这是就会将代码打上tag,当下一个版本需要进行开发的时候,还会在trunk进行开发。但是此时如果发现了上一个已发行版本(Released Version)有一些bug,或者一些很急迫的功能要求,而正在开发的版本(Developing Version)无法满足时间要求,这时候就需要在上一个版本上进行修改了。解决方法是基于发行版对应的tag,做相应的分支(branch)进行开发。

从SVN到Git

首先需要在本地安装SVN客户端,这里由于Mac本身就支持SVN(可以在命令行下使用”svn —version”进行检测),所以我使用的是命令行的形式。若是在Windows环境下也可以下载命令行或者图形化的客户端。

  1. 创建一个文件夹,使用checkout命令,从SVN服务器下载代码到本地
    Paste_Image.png
  2. 使用命令获取SVN用户信息,然后创建映射文件将SVN用户与Git用户进行映射

Paste_Image.png
Paste_Image.png

将这个SVN用户与Git用户进行映射文件保存为txt格式,命名为authors.txt

3.使用git svn clone 命令从SVN服务器取回代码,并在本地创建Git仓库,同时使用之前创建的用户映射文件

Paste_Image.png

这里使用git svn clone的语法为:

  • 如果SVN仓库为不标准的仓库(没有trunk、branches、tags)使用:
    git svn clone --trunk=/trunk --branches=/branches --branches=/bugfixes --tags=/tags --authors-file=authors.txt <svn-repo>/<project> <git-repo-name>
  • 如果SVN为标准仓库:
    git svn clone --stdlayout --authors-file=authors.txt https://svn.atlassian.com/Confluence ConfluenceAsGit

4.将通过git svn clone获得仓库,使用git clone当前目录 目的目录**” 命令克隆到本地其他地方,使用git remote rm origin去除仓库的上游

5.使用命令git remote add origin xxxxx(git仓库)将这个远程仓库添加到本地仓库的上游

6.使用命令git push origin master提交代码

至此大功告成,而且转换的Git仓库还保留着原先SVN中开发人员的提交纪录。