系列文章:
对于实际的存量项目而言,从SVN迁移到Git时是必须保留分支、Tag及提交记录的,以下以Bitbucket为例总结某个实际SVN代码仓库迁移到Git代码仓库的全过程。
一、建立SVN用户到Git用户的映射文件userinfo.txt
根据官网的文档:
在Subversion中,每一个人提交时都需要在系统中有一个用户,它会被记录在提交信息内。如果想要将Subversion用户映射到一个更好的Git作者数据中,你需要一个Subversion用户到Git用户的映射。
我们可以在对应SVN管理的工程文件夹下,使用如下命令获取到某个文件夹下所有提交者的名字:
svn log --xml|grep "^' '{print $2}'|awk -F '' '{print $1}' > userinfo.txt
1
svnlog--xml|grep"^''{print $2}'|awk-F'''{print $1}'>userinfo.txt
这会将SVN的提交技术输出为XML格式,然后提取出作者信息,再重定向到userinfo.txt文件中。请注意:
1、由于用到grep、sort、awk,因此在Windows环境中需要在bash中运行,如果没有的话先安装Git即可;
2、需要安装svn的命令号工具,如果没有的话需要安装下:
SVN命令行工具
得到的userinfo.txt文件只包含了提交者,形如:
导出SVN提交者
接下来需要按照如下的格式完成映射:
SVN与Git用户映射
二、使用git svn clone克隆一个包含了trunk、branches和tags的完整SVN代码仓库
一个典型的SVN仓库(该项目代号为eisp-eipsc-parent)形如:
一个典型的SVN仓库
我们使用如下命令进行克隆(首次执行时会被提示输入SVN的用户名):
$ git svn clone http://197.*.*.*:*/eisp/EIPSC/code/ --no-metadata --authors-file=userinfo.txt --trunk=trunk --branches=branch --tags=tag --no-minimize-url eisp-eipsc-parent-to-git
1
$gitsvnclonehttp://197.*.*.*:*/eisp/EIPSC/code/ --no-metadata --authors-file=userinfo.txt --trunk=trunk --branches=branch --tags=tag --no-minimize-url eisp-eipsc-parent-to-git
其中:
参数–authors-file表示SVN账号映射到Git账号的文件,所有的SVN提交者都要做映射;
参数–trunk表示主干所在目录;
参数–branches表示分支所在目录;
参数–tags表示标签所在目录;
参数–no-metadata表示不导出SVN元数据;当想要将Git仓库中的提交镜像回原SVN仓库中时,需要保留元数据。
参数–no-minimize-url表示不尝试读取上级目录;
git svn clone
如果不使用–no-minimize-url,则可能会导致在clone时扫描不正确的路径(Using higer level of URL):
不使用–no-minimize-url时Git默认会搜索上级目录
请注意,该–authors-file文件中必须包括SVN工程所涉及所有提交者的信息,如果缺少会报错(请注意,git svn执行时会将所有历史branch找到,即使该branch已经被删除,这些被删除分支中可能还有别的提交者,因此可能会报错,需要在遇到错误时再添加):
userinfo.txt中必须包含所有提交者的映射信息
当保留所有分支和提交记录时,git svn clone可能需要执行很久(This may take a while on large repositories),执行成功后形如:
git svn clone执行完成
此时可以看到master分支中的提交记录被完整保留了:
SVN中的原提交记录
三、处理标签及分支
接下来我们需要处理SVN的标签及分支。直接执行git branch -a命令,我们会发现本地只有master一个分支,SVN的分支和标签都被当做了远程分支:
本地只有一个master分支
执行git show-ref可以看到所有的引用:
git show-ref
首先,处理标签,创建本地标签并删除对应的远程分支:
git for-each-ref refs/remotes/origin/tags |cut -d / -f 5-|grep -v @| while read tagname; do git tag "$tagname" "origin/tags/$tagname"; done
git for-each-ref refs/remotes/origin/tags |cut -d / -f 5-|grep -v @| while read tagname; do git branch -r -d "origin/tags/$tagname"; done
1
2
gitfor-each-refrefs/remotes/origin/tags|cut-d/-f5-|grep-v@|whilereadtagname;dogittag"$tagname""origin/tags/$tagname";done
gitfor-each-refrefs/remotes/origin/tags|cut-d/-f5-|grep-v@|whilereadtagname;dogitbranch-r-d"origin/tags/$tagname";done
处理标签
然后,在本地针对每一个远程分支创建对应的本地跟踪分支:
git for-each-ref refs/remotes/origin/ |cut -d / -f 4-|grep -v @| while read branchname; do git branch "$branchname" "refs/remotes/origin/$branchname"; done
git for-each-ref refs/remotes/origin/ |cut -d / -f 4-|grep -v @| while read branchname; do git branch -r -D "origin/$branchname"; done
1
2
gitfor-each-refrefs/remotes/origin/|cut-d/-f4-|grep-v@|whilereadbranchname;dogitbranch"$branchname""refs/remotes/origin/$branchname";done
gitfor-each-refrefs/remotes/origin/|cut-d/-f4-|grep-v@|whilereadbranchname;dogitbranch-r-D"origin/$branchname";done
处理分支
根据官方文档的描述,git svn会创建一个名为trunk的额外分支,它对应于Subversion的默认分支,然而trunk引用和master指向同一个位置。鉴于在Git中master最为常用,因此我们可以移除额外的分支:
删除无用的trunk分支
此时,可以观察到分支结构正常了:
正确的分支
四、移除在SVN中已经被删除的分支
在git svn命令执行的过程中,已经在SVN中被删除的分支也会被fetch到。例如,如下的提交对应的SVN分支实际早就被删掉了,可以看到提交记录是空的:
在SVN中已被删除的分支也被GIT还原了
我们可以利用如下的命令分别列出Git分支和SVN中的实际分支:
分别列出GIT和SVN的分支
然后使用diff命令找出不在SVN中的分支,然后将其删除:
删除已从SVN中删除发分支
这时再次观察分支接口,已经与SVN一致:
正确的分支
六、添加Git远程仓库地址
配置Git的username和email,并配置仓库的远程地址(需要在Bitbucket中先创建对应的Repository):
git config --global user.name ***
git config --global user.email ***
git remote add origin http://******/******.git
或
git remote set-url origin http://******/******.git
1
2
3
4
5
gitconfig--globaluser.name ***
gitconfig--globaluser.email ***
gitremoteaddoriginhttp://******/******.git
或
gitremoteset-urloriginhttp://******/******.git
七、Push
将所有分支与标签推送到远程仓库:
git push origin --all
git push origin --tags
1
2
gitpushorigin--all
gitpushorigin--tags
这样,我们就可以在Bitbucket中看到原SVN仓库相关的所有分支:
Bitbucket中可以看到原SVN仓库的所有分支
标签:
Bitbucket中可以看到原SVN仓库的所有标签
及提交记录:
Bitbucket中可以看到原SVN仓库的所有提交记录
参考文档:
1、https://git-scm.com/book/zh/v2/Git-%E4%B8%8E%E5%85%B6%E4%BB%96%E7%B3%BB%E7%BB%9F-%E8%BF%81%E7%A7%BB%E5%88%B0-Git,官方迁移文档;
2、https://blog.csdn.net/ouyang_peng/article/details/80372805
3、https://stackoverflow.com/questions/5914681/git-svn-bulk-removing-orphaned-remote-branches/7209462#7209462