首页 置换 选车 估价 问答 生活 经销商 车管所 汽车资讯 汽车销量 车牌查询 今日油价 天气预报
您的位置: 首页 > 生活 > 科技 > 版本管理说明文档(版本控制指引)
版本管理说明文档(版本控制指引)
更新时间:2024-07-21 12:50:37

版本管理说明文档?产品版本项目/子项目所定义的版本,两节:x.y如智计划1.2,那么这个产品版本号为1.2,我来为大家讲解一下关于版本管理说明文档?跟着小编一起来看一看吧!

版本管理说明文档(版本控制指引)1

版本管理说明文档

概念

产品版本

项目/子项目所定义的版本,两节:x.y。如智计划1.2,那么这个产品版本号为1.2。

工程版本

代码构建产物的版本。工程版本号通常为四节,x.y.z.build。x.y 继承产品版本号;z在敏捷项目团队中是冲刺编号,在瀑布团队中为流水号。该节用于区分不同的研发、上线周期;build为构建流水号,通常由构建工具自动生成。

测试代码同样也有工程版本号。目前测试代码没有发布流程,也没有通过工具发布,所以z.build由测试团队人员自行决定。原则上每一次正式交付,变更z。

发布标签

每一次发布到生产,在git代码库中,给对应的commit标记一个标签,值为部署物的工程版本,即x.zy.z.build。

目标

统一分支管理策略以及定义。版本化一切,最终提高项目的团队合作效率、加速新功能开发和发布管理。

原则
  • 采用GitHub Flow策略(推荐)或基于主干开发策略。
  • 要求项目有完善的自动化测试、持续集成和部署等相关的基础设施。
  • 版本化一切。
  • 团队有代码审查的相应流程。
  • 具备自动部署的条件
规范代码仓库
  • 必须:代码应放在集团统一的代码仓库。
  • 必须:工程的可见性不能设置为public。
  • 必须:只允许给项目相关开发人员配置权限,并应该遵循最小授权原则。
  • 必须:代码项目创建在团队空间内,不允许放在个人空间。
  • 建议:团队空间命名格式为:group/[subgroup]。group为产品线简称,如果产品线有多个子产品,再加上subgroup。subgroup为子产品简称。如 gaia/gfs,group=gaia,subgroup=gfs。
  • 建议:代码项目命名格式为:项目代号-模块[-子模块][-孙模块]。如:gaia-gfs-demo,halo-wechat。这样,GIT中完整的空间-项目名为:gaia/gfs/gaia-gfs-demo。
分支命名【GitHub Flow】
  • 必须:master分支被保护,不允许直接提交至master。
  • 必须:创建分支使用有意义的名称头,功能开发用 feature/{JIRA编号}-*,bug修复用 bug/{JIRA编号}-*,热修复用 hotfix/{JIRA编号}-*。如 feature/XM1907901-1390-enable_audit_log_for_inventory, bug/XM1907901-1403-xxxxxxx。
  • 建议:创建分支开始后,就创建一个MR,用于描述思路,并记录讨论过程。
  • 建议:未完成的MR以WIP:开头,如:“WIP:用户1分钟未有动作,自动锁屏”。
  • 必须:至少有一个成员同意合并,才允许合并分支。
  • 建议:合并分支时,使用 --squash,或选中gitlab界面上的"[X]Squash commits when merge request is accepted"。
版本
  • 必须:每一次准备发布生产的交付物,打上发布标签,并记录Release Notes。
  • 建议:数据库有版本号。不同版本的数据库变更脚本,支持幂等操作,以便自动化完成升级/降级。
  • 建议:测试用例、测试数据也有版本号,要么和代码工程版本一致,要么自定义,和代码工程版本有对应关系。
  • 建议:推荐使用Flyway,EntityFramework Migrations来管理DB版本。
推荐实践版本号使用场景
  1. 敏捷项目冲刺开始,定义本冲刺版本的前三节。
  2. 提交、解决、关闭bug时,正确填入了DevOps中对应的工程版本号。
  3. DevOps构建时,根据前三节,自动补充最后一节的编译流水号。
  4. 发布至生产环境时,DevOps根据工程版本,自动生成tag标签。
  5. 如果只通过DevOps部署,则没有冲刺版本。DevOps根据产品版本,自动加上制品的上传批次号,如1.2.13,以追踪各环境和不同版本部署物的对应关系。
假设场景

项目名称

开发启动时间

移交测试时间

回归时间

上线时间

XX项目

9月1日

9月15日

9月25日

9月26日

开发流程

序号

时间

事项

描述

命令

说明

1

9月1日

从master新建分支

从master创建分支。分支名称:feature/11-Add_redis_support

git checkout master

git pull

git checkout -b feature/11-add_redis_support

git push --set-upstream origin feature/11-add_redis_support

所有参与人员都提交到此分支

2

9月2日

设计、编写代码与测试

提交、提交、提交

git add --allgit commit -a -m "move display name to redis" git push

3

9月3日

开启MR,以开启讨论和Review

从gitlab的站点中创建一个MR。

如果并未做完,MR以"WIP:"开头

4

9月15日

讨论、修改、测试

讨论方案、修正review的改进项。

git add .

5

9月16日

循环修复bug并不断push到远程分支。

git commit -am "move on and on"

6

……

每日merge master代码到分支。

git merge master

7

9月25日

自动化、人工验收全部通过,MR通过

master代码可以发布时,打上版本号标签,1.1.0

git tag add "1.1.0"

git push --tag

选中 "Squash commits when merge request is accepted.“

选中 "Delete source branch when merge request is accepted"

8

9月26日

部署

生产环境部署master。

通告其他分支开发人员尽快merge master代码

,
相关推荐RECOMMEND
微生物菌肥治疗苹果腐烂病(酵素菌肥在苹果和梨树上的应用)
微生物菌肥治疗苹果腐烂病?酵素菌肥在苹果上的应用,下面我们就来聊聊关于微生物菌肥治疗苹果腐烂病?接下来我们就一起去了解一下吧!微生物菌肥治疗苹果腐烂病酵素菌肥在苹果上的应用1.苹果需肥特点苹果树体高大...
vivo手机的分屏模式在哪里(什么是分屏功能)
vivo手机的分屏模式在哪里?vivo手机的分屏模式在设置里,Vivo手机分屏功能的使用办法:进入设置--分屏多任务--开启消息分屏/分屏多任务开关,并开启QQ、微信、信息的通知显示为悬浮图标,现在小...
安装台式电脑的步骤(关于安装台式电脑的步骤)
安装台式电脑的步骤?安装CPU处理器轻压脚座旁边的拉杆,掀起上盖并移除CPU脚座保护盖确认CPU凹槽与角落箭头,小心轻放至CPUSocket位置确认CPU凹槽与角落箭头,小心轻放至CPU插座位置,下面...
电脑什么配置比较好(怎么选择配置好的电脑)
电脑什么配置比较好?根据实际用途和预算选择电脑,是要笔记本还是台式机,笔记本有商务本和游戏本,我来为大家讲解一下关于电脑什么配置比较好?跟着小编一起来看一看吧!电脑什么配置比较好根据实际用途和预算选择...
游戏皮肤设计软件(软件介绍)
游戏皮肤设计软件?游戏设计中UI设计一般使用软件:AdobePhotoshop、Adobeillustrator、AfterEffects、AxureRP,现在小编就来说说关于游戏皮肤设计软件?下面内...
苹果手机功能太多(苹果手机那些让人无法忍受的地方)
苹果手机做的最好的就是他的IOS系统,没有那么多垃圾广告,对APP管理很严格,用个三四年也不会卡的。但是苹果也有让人头疼的地方:1、返回手势不好用苹果手机的返回键在左上角,不如安卓手机在下面,有时候单...