实际操作 Svn 迁移到 Git

最近把一个开发了很久的项目从公司的 svn 服务器迁移到 GitLab 上,折腾了几天。我们的 svn 目录结构不是很标准,所以网上的资料没一个能够照搬用的。Anyway,最后成功了,我这里详细记录一下,供参考。

本文地址:https://segmentfault.com/a/1190000007039598

Reference

SVN 迁移到GIT
svn迁移到Git
SVN迁移到Git的过程(+ 一些技巧)
git-svn 使用环境和步骤
git如何恢复本地删除的文件
git alternatives to “svn info” that can be included in a build for traceability?
svn2git
为git配置扩展命令
SVN、GIT生成版本号
git使用规范
Git 添加空文件夹的方法
转:批量查找空文件夹并放置.gitkeep或.gitignore
git add --all 为啥不能添加空文件夹,这样设计的初衷是?
git 为何不能添加空文件夹?
Git 里面的 origin 到底代表啥意思?
新手请教:Git 里面的 origin 到底代表啥意思?
git 查看分支 以及所对应的remote
.gitignore 不起作用
git 放弃本地修改更新
git 提交到本地但未push到远端的代码
Git 分支管理和冲突解决
git cherry-pick合并某个commit
Git错误non-fast-forward后的冲突解决
Git下的冲突解决
Git学习笔记05--git stash

看了好多资料……

Svn 代码库情况

我们的 svn 代码库的 URL 当然是机密啦。不过大致原理上,我需要迁移的目录状况如下:

主分支(在 git 上应成为 master 分支):
http://rdsvn.company.net/some_mid_path/Branches/main

此外打了几个tag:
http://rdsvn.company.net/some_mid_path/Branches/main_tag_25189
http://rdsvn.company.net/some_mid_path/Branches/main_tag_28141
http://rdsvn.company.net/some_mid_path/Branches/main_tag_28576

导出 svn 工程

首先,我们需要git-svn

$ sudo yum install git-svn
or
$ sodu apt-get install git-svn

原理上,就是使用git svn clone ...命令。如果你只是简单的执行这个命令的话:

$ git svn clone http://rdsvn.company.net/some_mid_path/Branches/main

那么我们只是将主分支及其 log 取到了本地,但是其他的分支并没有。如果要把所有的分支都 checkout 出来的话,需要用到--trunk--tags--branches等选项。

需要注意的有三点:

  1. 除了trunk单词是单数之外,其他的选项单词,请注意是复数。前者就是主分支的目录了,而后者表示的则是对应各个分支 / 标签的上层目录。Git-svn 会将该目录下的所有子目录视为一个独立的分支 / 标签进行导出。
  2. 这几个选项指定的都是相对路径,相对于你在git svn clone后面紧跟着的路径的位置。所以请不要在这些选项里面指定诸如 “http://” 开头的绝对地址。
  3. 除了 trunk 之外,其他几个相关选项可以重复指定。如果你的分支 / 标签分别在 svn 目录上的不同文件夹下,可以多次指定。

于是,对应我们的实际情况,git-svn 命令是这样的:

git svn clone http://rdsvn.company.net/some_mid_path/   \  # 注意这里并没有把主分支的路径写完整
--trunk="Branches/main" --tags="Branches"

稍等一会儿,就可以看到整个 svn 的主分支及分支都被导出来了,一颗赛艇!

分支处理

执行git branch -a可以看到相应的分支已经按照我们指定的选项建立起来了。我的实际情况,分支是这样的:

    trunk
    tags/main_tag_25189
    tags/main_tag_28141
    tags/main_tag_28576

这几个分支都被视为 Git 的远程分支,你的本地仓库暂时是空的。可以使用git checkout -b ...来将这几个分支拉到本地。

讲道理,svn 上的分支命名和 git 上的分支命名规则未必是一致的,因此这个时候你会想要重新命名分支。我的建议是这么操作:

  1. 在这个仓库中,首先把这几个虚拟的远程分支 checkout 到本地保存下来,这样可以保存 change log
  2. 向服务器上传主分支,一般分支名就是 master
  3. 将复制出来的其他分支,推到 git 服务器上,按照你希望的规则进行命名

上传到 git 服务器

首先要在 git 服务器上创建一个空的工程,比如 “git@rdgit.company.net/some_mid_path/some_group/firmware.git

然后在本地仓库中执行:

git remote add origin git@rdgit.company.net/some_mid_path/some_group/firmware.git

然后将主分支上传:

git push origin trunk:master

其他的分支也是利用这个语句创建新分支上传。

完成之后,在 git 服务器上就可以看到完整的 change log 以及分支变化情况啦。

关于空目录

其实迁移的时候还需要注意一个问题,那就是 svn 支持空目录的版本控制,但是 git 不支持。

导出 svn 之后,最好对比一下原始的 svn 工程内是否有空目录。如果有,那么你需要手工(或者写脚本)在导出的 git 工程中创建这些目录,并且在目录中建立一个 “.gitkeep” 文件(这是约定俗成的做法),并且将这些文件git add .gitkeep,以加入 git 的版本控制。这样就以迂回的方式通过 git 版本控制了目录。


后台 / 嵌入式全栈之路
曾经的嵌入式 / 后台开发一枚,现在开始走向架构。本专栏没有高深技术,只讲基础组件、工具,请放心食用

电子和互联网深耕多年,拥有丰富的嵌入式和服务器开发经验。现负责腾讯心悦俱乐部后台开发

889 声望
202 粉丝
0 条评论
推荐阅读
JSON 这么可爱,让我们用千字短文吃透它吧!
JSON,一个伟大的协议,前端工程师的卓越发明!相信 99% 的程序员都认识 JSON,它作为前后端交互的热门协议,因其易理解、简单、灵活和超强的可读性,得到了互联网的广泛欢迎,甚至很多微服务之间的传输协议中也...

amc3阅读 1.4k评论 1

openKylin 0.9.5版本正式发布,加速国产操作系统自主创新进程!
2023年1月12日,中国桌面操作系统根社区openKylin(开放麒麟)正式发布openKylin 0.9.5操作系统版本。此版本充分适应5G时代需求,打通平板,PC等设备,实现多端融合,弥补了国产操作系统的短板,有效推动国产操作...

openKylin6阅读 8k

封面图
Git的一些最基础操作-以项目为例
在自己刚接触git的时候,心里一直有一个疑问,那就是什么是git?git能用来干什么呢?git是一个分布式的版本控制系统。 那么现在你就知道了,git肯定是用来管理代码版本的,而且还是分布式的。

淼淼真人2阅读 3.6k

git 多用户配置(多用户 & 公司/个人)
多用户配置公司和github,经常会遇到要多用户使用git的情况,以下为配置信息,以下拿xiaoxuete1 & xiaofute2举例设置ssh-key {代码...} 会提示存储的文件名,输入如果需要push时确认的密码,可在该步骤输入.pub文件...

小夫特1阅读 7.4k

工作中常用的git命令
在这类系统中,像 Git,Mercurial,Bazaar 以及 Darcs 等,客户端并不只提取最新版本的文件快照,而是把原始的代码仓库完整地镜像下来。这么一来,任何一处协同工作用的服务器发生故障,事后都可以用任何一个镜像...

vipbic4阅读 926

封面图
SegmentFault 思否技术周刊 Vol.78 — Git 必看技术补给
Git 的诞生是一个非常有趣的故事。1991年 Linus 开源了 Linux 内核,无数 Linux 爱好者在世界各地为 Linux 编写代码,那么问题来了,这些代码该如何管理呢?起初 Linus 使用 BitKeeper(BitMover 公司的版本控制软...

Beverly3阅读 2.1k

封面图
记一次使用gdb诊断gc问题全过程
上次解决了GC长耗时问题后,系统果然平稳了许多,这是之前的文章《GC耗时高,原因竟是服务流量小?》 然而,过了一段时间,我检查GC日志时,又发现了一个GC问题,如下: 从这个图中可以发现,我们GC有一些尖峰,...

扣钉日记2阅读 1.1k

封面图

电子和互联网深耕多年,拥有丰富的嵌入式和服务器开发经验。现负责腾讯心悦俱乐部后台开发

889 声望
202 粉丝
宣传栏