Gitea:从SVN迁移到Git

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

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<user@example.com>

     

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

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

svn log -r 1:HEAD --xml | grep "<author" | sort -u | awk -F '<author>' '{print $2}' | awk -F '</author>' '{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 <tagname> <object>  在git本地创建tag。tagname为经过正则处理后的字符串;若不指定<object>,则tag默认以当前HEAD的版本号创建。这里不使用默认值,通过<object>指定为:该refs 的Hash值
  • git branch-D -r  删除remote远端refs信息
#然后再for循环调整branch(其中“fromsvn”为前文指定的--prefix)
for b in $(git for-each-ref --format='%(refname:short)' refs/remotes/fromsvn);
do
    branchname=${b/fromsvn\//}
    git branch ${branchname,,} refs/remotes/$b && git branch -D -r $b;
done;

命令说明: 

  • git for-each-ref  git命令,列出匹配指定模式的git内部refs(包括“.git/”和“.git/svn/”目录下的)并以指定的格式输出。对于branch输出形式:refs/remotes/fromsvn/XXX(其中fromsvn为前文指定的–prefix)。可查看通过git svn初始化命令生成的.git/config文件内容,找到SVN branch映射到git本地refs名字。
  • ${
    branchname,,}  Bash语法。结构为${
    VAR,,},将表示将变量值全部转为小写。
  • git branch <branchname> <start-point>  在git本地创建branch。若不指定<start-point>,则Branch默认以当前HEAD的版本号创建。这里不使用默认值,通过<start-point>指定为:该refs 的Hash值
  • git branch-D -r  删除remote远端refs信息

5、转换ignore文件(根据实际需要选择是否执行,此处不执行)

git svn show-ignore > .gitignore
git add .gitignore
git commit -m 'Convert svn:ignore properties to .gitignore'

6、其他调整。以上处理完成后,应检查分支和tag项是否正确,若需要重命名或删除历史不用的branch/tags等,则可以通过手工执行git命令完成。

7、查看并检查结果(在Bash中执行)
8、至此已经完成从SVN到git本地迁移工作。

git branch
git log
git tag

9、下一步,从git本地推送到gitea远端仓(在Bash中执行):

#增加git远端仓定义
git remote add origin_base http://20.200.54.51:3000/gsyspm/base_repos.git


#将本地仓所有分支推送至远端仓(若弹出输入用户密码,请输入gitea_admin用户和密码)
git push --all origin_base


#将本地仓所有tag信息推送至远端仓(若弹出输入用户密码,请输入gitea_admin用户和密码)
git push --tags origin_base

选项说明:

  • –all  将本地所有branch分支全部都推送至远端仓(不推送tag信息)。
  • –tags  在git push中的–tag选项表示将本地仓所有tag信息推送至远端仓(不推送branch分支)。

10、通过浏览器查看gitea服务端的结果。

今天的文章Gitea:从SVN迁移到Git分享到此就结束了,感谢您的阅读,如果确实帮到您,您可以动动手指转发给其他人。

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。
如需转载请保留出处:https://bianchenghao.cn/30562.html

(0)
编程小号编程小号

相关推荐

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注