背景介绍
最近在项目开发中遇到一个问题,需要将老git仓库中的部分或者全部分支迁移到另外一个新的仓库对应的分支上,并且需要保存老仓库分支的提交记录。网上的方案踩坑不少,经过实战发现了简单有效的操作方式,大家放心食用。
操作步骤
-
clone老仓库
$ git clone <仓库地址>
clone后可以看到我们仓库名的名字是test_branch_1,进入该目录
$ cd test_branch_1
-
git fetch同步修改记录
-
添加新仓库地址
- 首先确认下已有仓库别名信息,使用git remote -v进行查看
$ git remote -v
- 首先确认下已有仓库别名信息,使用git remote -v进行查看
- 添加新仓库别名己地址信息
git remote add new_origin <新仓库地址>
添加后再次使用git remote -v命令即可查看新的别名及仓库是否设置成功
-
提交老仓库某个分支信息到新仓库某个分支
- 需要同步老仓库的分支必须要在本地checkout过,即本地存在过和远程对应的分支(例如现在需要迁移dev3的分支记录到新仓库的develop_3分支,那么dev3这个分支本地必须有同名或者关联到dev3不同名的均可以)
$ git checkout dev3
- 同步最新提交记录
$ git fetch
- 提交到新仓库对应分支下
$ git push new_origin dev3:develop_3
此处是将老仓库的dev3分支的所有记录同步到新仓库的develop_3的分支上,此时如果新仓库没有develop_3那么将会新建一个。但如果分支已经存在且有提交记录的话,可能会提交不成功,会出现如下信息
此时需要确认是否需要忽略已有提交,如果是的话可以使用--force命令进行强制提交,会将之前的记录全部覆盖,导致之前的记录不存在,需要谨慎使用
$ git push --force new_origin dev_2:develop_2
- 需要同步老仓库的分支必须要在本地checkout过,即本地存在过和远程对应的分支(例如现在需要迁移dev3的分支记录到新仓库的develop_3分支,那么dev3这个分支本地必须有同名或者关联到dev3不同名的均可以)
-
所有老仓库分支及记录同步到新仓库
-
使用git push new_origin --all即可推送所有在本地仓库的提交记录到新仓库名为new_origin的地址上。此方式如果新仓库有同名的分支名,默认不会推送,未重名的则会直接推送,此处可以看见dev3推送成功,dev4由于存在未进行同步关联,故无法推送成功。
-
如果想强制覆盖新仓库的同名分支,则可以使用--force命令。使用后将会强制覆盖新仓库同名的分支所有提交记录,谨慎使用
-
-
所有老仓库tag同步到新仓库
- 使用git push new_origin --tags即可推送老仓库的所有tags到新仓库中,注意事项和第五点相同
mirror方式推送更新
- 使用bare的方式克隆老仓库
git clone --bare <老仓库地址>
2、镜像push到新仓库地址
$ cd old-repository.git
$ git push --mirror <新仓库地址>
3、删除老仓库(可选)
$ cd ..
$ rm -rf old-repository.git
注意该方式会将新仓库所有其他分支全部删除,只保留老仓库的分支,适用于老仓库换地址迁移,不适用于迁移到新仓库已经有其他分支的场景
其他:
- 使用git clone <地址> --bare或者--mirror可以自动在本地库中创建所有remote分支信息,不需要一个个checkout,适用于分支较多的场景。
- mirror和bare的区别在于mirror保留了远程跟踪分支,注释等并设置refspec配置,mirror主要用于仓库备份,后续可以使用git fetch、git remote update方便进行更新remote操作.