Gitea：从SVN迁移到Git

目录

环境信息

迁移步骤

---

SVN和Git都是优秀的版本管理工具。不幸的是，对于从SVN迁移到Git的过程、命令和说明，网上不少文章存在误导性。因此本文以Gitea为例，演示从SVN迁移到Git的详细过程。

本文前提条件：

• 已经完成Gitea安装（含Git软件安装）
• 在Gitea中，已完成了初始配置并正常运行
• 在Gitea中，根据需要配置Organization、Teams、User Accounts等组织协作信息（可选）
• 在Gitea中，已经创建Repository（这里名字为：gsyspm，无需对该Repository初始化）

环境信息

在以上git Repository创建完成且未被初始化的情况下，需要从原SVN仓库迁移导入至Git，包括在SVN的提交Commit 和作者log日志。需要导出的SVN信息：

• SVN仓根URL：http://20.1.1.11:7001/usvn/svn/sys_pm
• SVN仓中trunk相对于根的路径：pmis/01develop/02code/trunk
• SVN仓中branches相对于根的路径：pmis/01develop/02code/branches
• SVN仓中没有Tags信息
• 需要迁移的SVN版本号范围：从1至HEAD

迁移步骤

以下步骤通过git svn命令完成从SVN至Git的迁移：

1、在任意PC电脑上（能够访问SVN和Gitea）创建迁移临时用目录：migrate_svn_to_git/

2、进入该目录。创建文本authors_map.txt，存放SVN作者至Git作者映射信息文件，格式形式如下：

loginname=JoeUser

     

或者可通过以下方式自动生成该作者映射文件。

   进入本地既有的SVN目录（该目录已经完成从SVN checkout至最新）通过以下命令生成（在Bash中执行）authors_map.txt文件，然后将生成得到的该txt文件拷贝至 migrate_svn_to_git/ 目录下：

svn log -r 1:HEAD --xml | grep "' '{print $2}' | awk -F '' '{print $1"="$1"<"$1"@yykj.com>" }'  > authors_map.txt

3、通过以下两条git svn命令从SVN仓导出至本地（在Bash中执行）：

#以SVN仓根URL对当前本地目录进行git初始化
git svn init http://20.1.1.11:7001/usvn/svn/sys_pm --prefix fromsvn/ --no-metadata --username=LOGIN_SVNUSER  --trunk=pmis/01develop/02code/trunk --branches=pmis/01develop/02code/branches 



#从SVN仓导出到本地git仓中（耗时可能很长甚至几天几夜）
git svn fetch  -r 1:HEAD --authors-file=authors_map.txt

选项说明：

• --prefix  指定“.git/”和“.git/svn/”目录下的"refs/remotes/$prefix/"中的prefix值（该值末尾有斜杠），若不指定，默认为“origin/”（可近似理解为远端SVN仓的别名，之所以说近似是因为它不是标准的git远端仓库的概念，通过git remote命令也无法显示此别名）
• --no-metadata  不导出SVN元数据信息（导出时本地不会生成.svn目录）。若还需要从git反向导入至git，需要导出SVN元数据信息，则不能使用此选项
• --username  指定登录SVN用户名。若不指定，则以当前登录操作系统用户作为默认SVN登录名
• --trunk --branches --tags  SVN的标准结构是主干/分支/Tags的目录命名是"trunk/branches/tags"且它们直接在SVN仓根目录下，对于标准机构则应把选项改为--stdlayout（或-s）。由于我们这里SVN不是标准若SVN结构（主干分支目录命名符合标准，但不是直接放在SVN仓根目录下），所以通过--trunk及--branches分别指定其相对于SVN仓根目录的相对路径
• -r 指定导出的SVN版本号起止范围
• --authors-file  指定从SVN作者到git作者的映射文件。若SVN中存在的提交作者范围超出该映射文件范围，则会报错而中止

4、导出后tags和branch信息在.git/svn/目录下，需要先据此创建git本地tags和branch，然后待后面步骤推送至gitea的远端。即，tags和branch的refs信息有三类：

• SVN的remote远端refs信息（导出后，存放在.git/svn/refs/remotes目录下）
• git本地仓的refs信息（存放在.git/refs目录下）
• git的remote远端refs信息（存放在.git/refs/remotes目录下）

通过以下命令将“SVN的remote远端refs信息”转换为“git本地仓的refs信息”，然后清理删除“SVN的remote远端refs信息”：（在Bash中执行）

#先for循环调整tags（其中“fromsvn”为前文指定的--prefix）
for t in $(git for-each-ref --format='%(refname:short)' refs/remotes/fromsvn/tags);
do
    tagname=${t/fromsvn\/tags\//}
    git tag ${tagname} $t && git branch -D -r $t;
done;

【注】refs在git内部就是指针，指向40字节的SHA-1哈希值。命令中refs/remotes为指向远程各分支的head指针，refs/tags本地tags列表。

命令说明：

• git for-each-ref  git命令，列出匹配指定模式的git内部refs（包括“.git/”和“.git/svn/”目录下的）并以指定的格式输出。对于Tag输出形式：refs/remotes/fromsvn/tags/XXX（其中fromsvn为前文指定的--prefix）。可查看通过git svn初始化命令生成的.git/config文件内容，找到SVN Tag映射到git本地refs名字。
• ${t/fromsvn\/tags\//}  Bash语法。结构为${VAR/PATTERN/NEWSTRING}，将变量值进行正则匹配并替换。这里的意思为将变量值中“fromsvn/tags/”字符串删除。
• git tag