最近接手一个非常老的项目,因为使用SVN进行控制,而现在大部分都已经使用Git进行版本控制,所以就想迁移到Git,Git的优点自然是不用在这里说了,必经是当前公认最好用的。

因为项目比较老,代码比较多,提交多达3w多次,同时svn还有几十个分支和标签,这些历史记录丢失将对今后追溯debug造成很多麻烦,所以关键是如何才能保留所有的这些提交记录、分支、标签。

svn转换git

转换仓库

1. 提取开发者信息

为了实现正确的数据迁移,我们要对开发者信息,即提交作者的信息做一个映射,这就需要先生成一个用户对应关系的文件,格式如下:

1
JefferyWang = JefferyWang <jefferywang@example.com>

为了能够快速从svn内提取作者信息,可以使用下面的脚本,来快速提取在svn内有过提交的用户名,然后再做映射的处理,生成上面格式的文件即可:

1
svn log -q | awk -F '|' '/^r/ {sub("^ ", "", $2); sub(" $", "", $2); print $2}' | sort -u

当然如果你们所有作者的邮箱后缀都是一样的,可以使用下面这段脚本:

1
svn log -q | awk -F '|' '/^r/ {sub("^ ", "", $2); sub(" $", "", $2); print $2" = "$2" <"$2"@example.com>"}' | sort -u > authors.txt

2. 仓库转换

标准的svn文件布局

标准的svn文件布局

如果你的svn仓库是标准的目录结构,即只包含/trunk, /branches, tags 几个目录的结构,那么可以直接在运行命令的时候加上参数--stdlayout

命令格式为git svn clone --stdlayout --authors-file=authors.txt <svn-repo>/<project> <git-repo-name>,下面是一个示例:

1
2
3
4
5
# git v1.x
git svn clone --stdlayout --authors-file=authors.txt http://svn.example.com/test_rep/demo_proj demo

# git v2.x
git svn clone --prefix="" --stdlayout --authors-file=authors.txt http://svn.example.com/test_rep/demo_proj demo

非标准的svn文件布局

非标准的svn文件布局

针对非标准的目录结构,我们分别做显式指定参数--trunk, --branches, --tags

1
2
3
4
5
# git v1.x
git svn clone --trunk=/trunk --branches=/branches --branches=/bugfixes --tags=/tags --authors-file=authors.txt http://svn.example.com/test_rep/demo_proj demo

# git v2.x
git svn clone --prefix="" --trunk=/trunk --branches=/branches --branches=/bugfixes --tags=/tags --authors-file=authors.txt http://svn.example.com/test_rep/demo_proj demo

大仓库的转换策略

有些svn仓库可能非常大,而转换过程是个非常漫长的过程,这个也取决于机器性能。因此,如果你不在乎老的一些历史记录的话,那么你可以只保留部分提交历史,来加速转换的过程。

命令格式:git svn clone -r${REVNUMBER}:HEAD --stdlayout --authors-file=authors.txt <svn-repo>/<project> <git-repo-name>

1
git svn clone -r52733:HEAD --stdlayout --authors-file=authors.txt https://svn.waterstrong.com/demo demo

3. 仓库清理

这里查看我们的仓库,就发现转换工作基本已经完毕了,如果你只关注trunk和master分支,那么可以不用在乎这一部分,直接跳到下一节即可。这一步主要是将分支和标签进行本地化。

git svn clone操作并不会将svn的分支和标签导入到新的git仓库里面,并且在本地分支中也找不到svn的分支和标签。转换后,其实是把svn的分支和标签导入为git的远程分支和标签了,如下面示意图所示:

仓库转换结果

这个策略主要是为了svn和git双向同步服务的,但是我们切换为git后,应该大部分都会禁止在svn再进行提交,所以我们就需要对这些进行一下清理。

清理后的结果

第一种方法:

Atlassian提供了一个工具svn-migration-scripts.jar,可以进行清理。

下载地址:

svn-migration-scripts.jar 下载

使用方法:

1
2
java -Dfile.encoding=utf-8 -jar ~/svn-migration-scripts.jar clean-git
--force

第二种方法:

只需要执行两个命令:

1
2
3
4
5
# 标签本地化
for t in $(git for-each-ref --format='%(refname:short)' refs/remotes/tags); do git tag ${t/tags\//} $t && git branch -D -r $t; done

# 分支本地化
for b in $(git for-each-ref --format='%(refname:short)' refs/remotes); do git branch $b refs/remotes/$b && git branch -D -r $b; done

当然,如果你使用git v2.x版本,你可能通过网上查询的资料,在执行git svn clone的时候没有加参数--prefix="",那么执行之后会在远程的分支名称前面添加origin/,直接按照上面的脚本处理会有问题,你可以按照下面的命令进行处理

1
2
3
4
5
# 标签本地化
for t in $(git for-each-ref --format='%(refname:short)' refs/remotes | grep "origin/tags"); do git tag ${t/origin\/tags\//} $t && git branch -D -r $t; done

# 分支本地化
for b in $(git for-each-ref --format='%(refname:short)' refs/remotes); do git branch ${b/origin\//} refs/remotes/$b && git branch -D -r $b; done

4. 收尾工作

添加远程仓库地址

1
git remote add origin JefferyWang@github.com:test/demo.git

将本地分支和标签推送到远程仓库

1
2
3
git push origin --all

git push origin --tags

参考资料