SVN迁移至GitLab，并附带历史提交记录（二）

与《SVN迁移至GitLab，并附带历史提交记录》用的 git svn clone不同，本文使用svn2git来迁移项目代码。

一、准备工作

  1. 安装Git环境，配置本地git账户信息：
git config --global user.name "XXX"
git config --global user.email "XXX@mail.com"

可通过命令git config -l 查看结果

  • Create a new repository
git clone http://xxx/testproject.git
cd testproject
touch README.md
git add README.md
git commit -m "add README"
git push -u origin master
  • Push an existing folder
cd existing_folder
git init
git remote add origin http://xxx/testproject.git
git add .
git commit -m "Initial commit"
git push -u origin master
  • Push an existing Git repository
cd existing_repo
git remote rename origin old-origin
git remote add origin http://xxx/testproject.git
git push -u origin --all
git push -u origin --tags
  1. 安装git-svn，运行git svn -h，若正常输出帮助信息，说明安装没问题。
  2. 安装ruby，运行ruby -h，若正常输出帮助信息，说明安装没问题。
  3. 执行下面命令安装svn2git，注意下面命令依赖ruby。
gem install svn2git

再运行svn2git -h，若正常输出帮助信息，说明安装没问题。

  1. svn账号与git账号映射，新建文件 userinfo.txt，左侧是SVN的账号，右侧是git账号信息，用=号连接：
svn1=git1<git1@mail.com>
svn2=git2<git2@mail.com>
svn3=gitx<gitx@mail.com>

注意：

  • 需要将涉及到的同步记录中的用户都做映射，否则在同步时可能会报错
  • 对于无法对应的人员，如离职人员，有SVN账号，但是没有现在的GIT账号，保险起见，可以采用无关紧要的账号进行对应，或者单独建一个账号也可以，例如使用的test账号进行标识的

二、导出SVN项目至本地

  1. 创建空文件夹用于存放SVN的代码，并将userinfo.txt文件放置在同一层级
│  userinfo.txt
└─ MyProject
  1. 鼠标右键 选中Git Bash Here 进入git命令行，执行：
svn2git svnUrl --authors userinfo.txt -v

这里的-v会输出执行过程的信息，方便debug。此处的 -r 12345:HEAD 表示从svn的12345版本到最新版本的提交记录，避免拉取所有数据量过大，操作耗时高。svnurl是svn项目地址。如果需要拉取所有记录，可去除 -r 12345:HEAD

三、与远程git仓库关联起来

  1. 进入项目文件夹，
cd MyProject
  1. 关联远程事先创建好的git项目
git remote add origin gitURL

如：git remote add origin http://192.168.1.xx:5678/MyProject.git

  • 查看关联情况:
git remote -v
  • 如果关联有误，可以删除关联
git remote rm origin
  1. 推送本地项目到git仓库
  • 提交记录之前，先拉取远程git项目文件(如：README.md)，否则直接提交会报错
git pull --rebase origin master
  • 拉取成功后，推送主分支trunk代码
git push -u origin --all

或

git push --all origin
  • 推送tags代码
git push -u origin --tags

ref:
1.从 SVN 到极狐GitLab的迁移指南
2. https://github.com/nirvdrum/svn2git

四、错误问题

  1. 在windows有下面错误：git checkout -f master
D:\MyProject>svn2git https:/xxx.com:8443/svn/SVN2GIT/ --authors authors.txt -v
Running command: git svn init --prefix=svn/ --no-metadata --trunk='trunk' --tags='tags' --branches='branches'  https:/xxx.com:8443/svn/SVN2GIT/
Initialized empty Git repository in D:/MyProject/.git/
Running command: git config --local --get user.name
Running command: git config --local svn.authorsfile authors.txt
Running command: git svn fetch
Running command: git branch -l --no-color
Running command: git branch -r --no-color
Running command: git config --local --get user.name
Running command: git config --local --get user.email
Running command: git checkout -f master
error: pathspec 'master' did not match any file(s) known to git
command failed:
git checkout -f master

去安装目录C:\Ruby30-x64\lib\ruby\gems\3.0.0\gems\svn2git-2.4.0\lib\svn2git，找到migration.rb文件，把#{trunk}、 #{tag} 、#{branch}两边的单引号删除，再重新执行上面命令。
参考自：svn2git - command failed

  1. Cannot setup tracking information
Running command: git branch --track "Test" "remotes/svn/xxx"
fatal: Cannot setup tracking information; starting point 'remotes/svn/xxx' is not a branch.

同理，找到migration.rb文件，搜索--track，如下：
修改前：

status = run_command("git branch --track \"#{branch}\" \"remotes/svn/#{branch}\"", false)

修改后：

status = run_command("git branch \"#{branch}\" \"remotes/svn/#{branch}\"", false) # remove '--track'

参考：svn2git: Cannot setup tracking information