基于git的代码版本管理规范及流程-简版

基于git的简单实用的版本管理规范及流程,包括:代码库的分布、人员角色的划分、代码提交合并流程、代码冲突处理、分支管理。
对于企业用户,推荐使用CODING 企业版

代码库分类

根据代码库分布的位置及作用,分为以下几类:

  • 主库:位于服务端,所有开发的代码最终都要合到主库。
  • 个人代码库(服务端):从主库fork出来,位于服务端。每个人自已开发的代码,由本地的git库push到每个人自己的个人代码库(服务端),再由个人代码库(服务端)合入主加。
  • 个人工作库:位于每个开发人员的开发机器,从个人代码库(服务端)clone到本地。每个开发人员开发的代码,先commit到个人工作库,再由个人工作库push到个人代码库(服务端)。

人员角色分类

这里说的角色,都是人员在主库上的角色。基于简化的原则,人员分为三类:

  • Owner:拥有主库的所有权限。
  • Committer:具有将开发人员的合并需求(MR)合入主库的权限。基于安全考虑,我们设置为只能通过MR的方式将代码合入主库,而不能直接push到主库。
  • Developer:只能从自己的个人代码库(服务端)提交合并代码的请求(MR),是否能够合入,由Committer进行审核。

CODING 企业版中,Committer在进行MR之前,可以对Developer提供的代码进行review,输入评审意见,并@给相关人员。
codereview

基本流程

在主库已经存在的情况下,日常操作流程如下:

  1. 开发人员从主库fork出自己的个人代码库。
  2. 开发人员将自己的个人代码库clone到本地,即个人工作库。
  3. 开发人员在开发了新代码后(包括新增和修改),先将代码commit到自己的个人工作库,再由个人工作库push到个人代码库。
  4. 开发人员提交从个人工作库到主库的MR,Committer审核后,决定是否将MR合入主库。
  5. 每个开发人员从主库pull最新代码到个人工作库。

分支管理

  • 主库缺省的master分支,是用来向生产环境发布的,所有合入的代码,原则上都必须是稳定的。
  • 主库除了master分支外,至少还要有一个活动分支,命名建议为:br_工程名_active,平时日常的开发都基于活动分支开发。即从个人工作库提交MR到主库时,指向的是主库的活动分支。活动分支测试稳定后,将主库的活动分支通过MR的形式,合并到主库的master分支,同时打上tag。
  • 如果软件运行过程中发现必须立即修改的bug,则从主库的master分支中,拉出一个bugfix分支。为修复这个bug的所有开发,都基于bugfix分支。待bugfix分支开发完成,并测试稳定后,将bugfix分支以MR的方合入主库的master分支。然后删除bugfix分支,视情况决定是否打tag。

CODING 企业版中,合并分支的同时,可以选择是否删除源分支,十分方便。
mergebranch

常见问题

此部分内容会根据情况进行相应的增加。

活动分支合入主分支时发生冲突

产生原因

平时基于活动分支开发,如果这个过程中为了修复bug而拉了一个bugfix分支,当bugfix分支开发完成并合入master分支后,如果bugfix分支和活动分支修改了相同的文件,则在活动分支合入master分支时就会产生冲突。

解决方法

  1. 从个人代码库(服务端)clone一个库到本地,即专门用于合并的个人工作库。(也可以用之前的个人工作库,但初学都容易混淆,建议单独clone一个。)
  2. 从主库的活动分支上pull最新的代码到本地。
  3. 从主库的master分支上pull最新的代码到本地。
  4. 此时会产生冲突,手工修复冲突,然后先commit到本地的个人工作库,再push到个人代码库(服务端)。
  5. 提交从个人工作库(服务端)到主库的MR(此时不会再有冲突),然后由Committer审核后将MR合入主库。

CODING 企业版简介

CODING企业版提供整套企业级的软件研发管理系统,让企业的管理人员可以更好地进⾏研发团队的项⽬管理,便捷而深入地把握开发进度,让开发流程⾼效可控。
CODING企业版从项⽬的管理,到代码管理,直到代码的推送和部署,CODING 企业版提供了一整套的完整解决方案。
coding

企业管理

企业管理提供企业个性化定制、企业概览和统计、项⽬及成员批量管理、项⽬权限一键开关、安全管理等一系列功能,可以满足企业基本管理的需求。

项目管理

提供当前企业最前沿的敏捷开发,全生命周期项⽬和任务管理,帮助企业更好的管理项⽬和任务,以应对快速变化的IT项⽬管理需求。

  • 简洁高效的任务指派
  • 云端共享的项目文件
  • 系统化的 Wiki 知识库
  • 多维度的项目统计

代码管理

代码管理提供以Git为基础的日常开发源代码版本管理,包括代码浏览、分⽀管理、发布管理、版本对比、合并请求、项⽬⽹络等,提供强于Git 的代码管理使用体验。

  • 代码仓库
  • 代码评审
  • 发布管理
posted @ 2017-12-06 22:38  飞鸿踏雪2018  阅读(14404)  评论(0编辑  收藏  举报