【git】subtree拆分大的git库到多个独立git库

【git】subtree拆分大的git库到多个独立git库

一、拆分一个子目录为独立仓库

bash 复制代码
# 这就是那个大仓库 big-project
git clone [email protected]:tom/big-project.git
cd big-project

# 把所有 `eiyo` 目录下的相关提交整理为一个新的分支 eiyo_code
git subtree split -P eiyo -b eiyo_code

# 另建一个新目录并初始化为 git 仓库
mkdir ../eiyo_code
cd ../eiyo_code
git init

# 拉取旧仓库的 eiyo 分支到当前的 master 分支
git pull ../big-project eiyo_code

二、推送给新的远端仓库

bash 复制代码
# GitHub 新建一个空仓库(无README.md  .gitignore LICENSE )  git://github.com:tom/eiyo_code.git

git remote add origin git://github.com:tom/eiyo_code.git
git push origin -u master # -u 或 --set-upstream 选项用于将本地分支与远程分支关联起来

三、清除一个子目录下所有内容和记录

这个还是要用万能的 filter-branch:

bash 复制代码
# 还是那个大仓库 big-project
git clone [email protected]:tom/big-project.git
cd big-project

# 清理 `master` 分支上所有跟 `eiyo` 目录有关的痕迹
git filter-branch --index-filter "git rm -rf --cached --ignore-unmatch eiyo" --prune-empty master

## 推送清理之后的数据
git push --force

至此,就将一部分eiyo 代码 分割成一个单独的仓库 并且保留日志。接下来科普一下 git subtree


四、git subtree 合并

git subtree:合并策略,通过git subtree命令能将依赖库某分支合并到主项目的分支中,在开发过程中,只需对主项目分支进行统一管理。

创建合并subtree add命令

命令如下:

bash 复制代码
git subtree add -P <prefix> <commit>
git subtree add -P <prefix> <repository> <ref>

两步走

(一)先fetch库再subtree add合并
  1. 先将依赖库fetch到本地仓库中
bash 复制代码
// 创建lib的远程版本库: 
git init --bare lib-rep
#-f:远端库添加后立即执行fetch操作
git remote add -f librepo ../lib-rep
  1. 通过git subtree命令将依赖库合并到主项目中
bash 复制代码
git subtree add -P lib librepo master  
(二)squash合并法

--squash: 适用于add/pull/merge子命令。先合并引用库的更新记录,将合并结果并到主项目中。

bash 复制代码
git subtree add --prefix=themes/jacman --squash https://[email protected]/it-boyer/jacman.git master   

五、subtree其他命令

git subtree支持创建(add)之外,还支持更新(pull),推送(push),合并(merge),抽离(split)以下命令:

bash 复制代码
git subtree pull -P <prefix> <repository> <ref>
git subtree push -P <prefix> <repository> <ref>
git subtree merge -P <prefix> <commit>
git subtree split -P <prefix> [OPTIONS] [<commit>]

(一)从子树库中拉取最新代码:

bash 复制代码
git subtree pull --prefix=themes/jacman --squash https://[email protected]/it-boyer/jacman.git master

(二)将自己的代码发布到子树库:

bash 复制代码
git subtree push --prefix=themes/jacman --squash https://[email protected]/it-boyer/jacman.git master

(三)相关参数:

bash 复制代码
q | --quiet
-d | --debug
-P <prefix> | --prefix=<prefix>      引用库对应的本地目录
-m <message> | --message=<message>   适用于add/pull/merge子命令。设置产生的合并提交的说明文本
--squash                             适用于add/pull/merge子命令。先合并引用库的更新记录,将合并结果并到主项目中。
使用此选项时,subtree add/pull会产生两个提交版本:一个是子项目的历史记录,一个是Merge操作。好处是可以让主项目历史记录很规整,缺点是子项目更新时常常需要解决冲突。一个更好的解决方案是:单独建一个分支进行--no-squash的subtree更新,然后再--squash合并到主分支。每次在此分支做操作前都需要先把主分支合并进来。参考:http://www.fwolf.com/blog/post/246

(四)split子命令选项:

bash 复制代码
--annotate=<annotation>              创建合成历史时有可能形成内容不同但提交信息完全相同的提交版本,使用这个选项在每个提交消息前加上此前缀用来区分。
-b <branch> | --branch=<branch>      创建合成的提交历史时,创建此参数指定的新分支包含生成的合成历史。<branch>必须是还不存在的。
--onto=<onto>
--rejoin
--ignore-joins

(五)使用sourcetree管理

  1. 配置 subtree 菜单:Repository -> Add/Link subtree...(添加/链接子树...) 在左边栏的SUBTREES(子树)中显示:

  2. 拉取依赖库的最新代码 在右边栏右击已存在的subtree,并选择 pull subtree...菜单项: 第二步的功能代码如下:

bash 复制代码
git -c subtree pull -P themes/.jacman --squash https://[email protected]/it-boyer/jacman.git master
相关推荐
无妄无望18 分钟前
Git,本地上传项目到github
git·github
小华同学ai18 分钟前
90.9K star!Open WebUI一键部署AI聊天界面,这个开源项目让大模型交互更简单!
github
郁大锤2 小时前
Windows 下 Git 入门指南:从安装、配置 SSH 到加速 GitHub 下载
windows·git·ssh
Emma歌小白2 小时前
gitee同步版本合并冲突
git
ba_pi2 小时前
Git分支管理方案
git
old_power2 小时前
【Git】Fork和并请求
git
不脱发的程序猿4 小时前
ARM Cortex-M (STM32)如何调试HardFault
github
兔子蟹子4 小时前
Git入门
git
Gazer_S5 小时前
【 Git 全局忽略文件完全指南:配置、规则与最佳实践】
git
-曾牛6 小时前
GitHub创建远程仓库
java·运维·git·学习·github·远程工作