Git分支管理规范构思


最近对于公司项目源码分支管理有一些规范构思,对于同一个项目而言,不同环境的源码管理、自动化部署方式、以及接口数据隔离等我们是否可以满足现状?

对于基础项目源码分支而言,一般有developmaster两个,develop来研发功能并测试没有问题后合并到master再发布到生产环境。

分支示意图

分支管理规范示意图

特性分支(feature)

如果项目比较大,协同人员比较多,每个研发人员的分工比较明确,针对这种情况我们如果还是简单的使用develop/master两个分支就不太能满足需求了,针对这个情况我们如何去规范化管理呢?

特性分支一般是基于develop开发分支衍生创建的,而且是本地分支(Local Branches),不太建议一个特性任务多个人同时使用,如果必须是多人协同的任务,那么该特性分支则会变成远程分支(Remote Branches),特性分支的任务完成后需要合并到develop分支并后续提交给测试人员进行测试。

任务分配到具体研发人员后,研发人员可以在本地创建特性分支,如果分支较多为了区分方便,我们可以定义一个分支名称的前缀,如:feature-,如果给我分配了用户管理的任务,那么我就可以在本地创建feature-user特性分支来研发。

紧急缺陷修复分支(bugfix)

如果代码已经发布,在运行过程中遇到了一个紧急的缺陷,针对这个缺陷我们需要怎么去修复呢?

首先我们需要基于master分支来衍生创建缺陷修复分支,该分支也应该是本地分支(Local Branches)不应该被推送到远程目标仓库,我们可以以bugfix-作为缺陷修复分支的前缀,如:bugfix-register-error

缺陷一旦修复完成后需要将bugfix-xxx分支的代码变动合并到master以及develop

  • 为什么合并到develop?

    遇到的缺陷不仅是master分支存在,因为master分支的代码是从develop合并而来的,所以我们需要同步合并到develop防止后续发版再次出现相同的问题。

  • 为什么合并到master?

    因为该缺陷是生产环境发现的,虽然我们合并到了develop分支,但是不保证距下次发版生产环境不再出现紧急的缺陷所以我们需要将代码合并到master

下一个版本分支(next-version)

如果项目是有规划根据迭代版本循序渐进的,那么建议使用next-version分支,那么为什么这么做呢?

顾名思义,next-version下一个版本当前版本源码一般存放于develop分支,而且当前版本是跟任务规划来的,不会涉及next-version分支的源码,这样就做到了版本之间的源码隔离,当前版本准备发布时防止发布下个版本未完成的功能。

next-version是基于develop分支衍生创建的,develop是当前版本,那么next-version就是下一个当前版本,develop一旦合并到master发布后就需要将next-version的代码合并到develop作为当前版本继续做后续研发。

支持自动化部署的分支

自动化部署可以极大的提高CI/CD效率,研发人员只需要关心业务功能怎么去实现,无需考虑代码怎么去部署,代码一旦被提交就可以触发自动化部署的程序,实现流水线的自动化部署业务。

开发环境自动化部署可以考虑使用Drone来配置,它很轻量级,在根目录下创建一个名为.drone.yml的文件即可搞定配置流程,它还可以结合支持私有部署的Git源码仓库:Gitea 实现钩子回调,部署也很简单使用docker部署一个管理端、一个运行节点即可。

参与自动化部署的分支一般为:developnext-version

master分支则是建议手动触发的方式来部署,可以使用Jenkins

常见问题

  • 功能还未研发完成,临时接到紧急任务,我怎么把未完成的工作保存并切换分支?

    可以使用git stash暂存工作空间的文件变动,暂存后就可以切换到其他分支做相关工作了,处理完成后返回未完成的分支执行git stash pop恢复暂存即可,git stash还有很多用法,可以参考官网文档:git-stash

作者

恒宇少年 - 于起宇

发布于

2022-10-14

更新于

2022-10-26

许可协议

评论