git.md 5.9 KB


title : 版本管理

Git

Git是一个开源的分布式版本控制系统,可以有效. 高速地处理从很小到非常大的项目版本管理。

组织结构管理

建立persagy组织,负责所有后台服务git代码管理。 组织下建立团队,包括公共项目团队、数字化交付、数据中台、集成框架、中控。 公共项目团队包括web前端、Android、IOS、WebRTC、U3D、Docker、artificial intelligence、framework等, 每一个公共项目代表一个技术领域。 所有业务团队公共,且与业务无关通用的代码采用公共项目团队内的git仓库管理。每个团队独立负责团队内git仓库建立。 每个git仓库对应一个idea的project,每个idea的project可以创建Module(模块)。 一般一个git仓库对应一个服务。 每个项目组构建组内的web项目,前台web项目也分层多个git仓库。 公司引入开源项目时,需要镜像开源项目的git仓库。引入的开源项目git镜像由公共项目团队管理。

目录结构如下:

└── persagy
    ├── Android
    ├── Docker
    ├── IOS
    ├── U3D
    ├── Web
    ├── WebRTC
    ├── artificial
    ├── framework
    ├── intelligence
    ├── 数字化交付
    │   ├── Android
    │   ├── IOS
    │   ├── Java
    │   └── Web
    ├── 数据中台
    │   ├── Android
    │   ├── IOS
    │   ├── Java
    │   └── Web
    ├── 集成框架
    │   ├── Android
    │   ├── IOS
    │   ├── Java
    │   └── Web
    └── 中控
        ├── Android
        ├── IOS
        ├── Java
        └── Web

GitFlow 使用规则

在使用Git的过程中如果没有清晰流程和规划,否则,每个人都提交一堆杂乱无章的commit,项目很快就会变得难以协调和维护。 Git版本管理同样需要一个清晰的流程和规范。我们参照Gitflow 来规范我们的Git使用。

Git Flow 流程图

GitFlow流程图

Git Flow 的常用分支

  • Production 分支 也就是我们经常使用的Master分支,这个分支最近发布到生产环境的代码,最近发布的Release, 这个分支只能从其他分支合并,不能在这个分支直接修改

  • Develop 分支 这个分支是我们是我们的主开发分支,包含所有要发布到下一个Release的代码,这个主要合并与其他分支,比如Feature分支

  • Feature 分支 这个分支主要是用来开发一个新的功能,一旦开发完成,我们合并回Develop分支进入下一个Release

  • Release分支 当你需要一个发布一个新Release的时候,我们基于Develop分支创建一个Release分支,完成Release后,我们合并到Master和Develop分支

  • Hotfix分支 当我们在Production发现新的Bug时候,我们需要创建一个Hotfix, 完成Hotfix后,我们合并回Master和Develop分支,所以Hotfix的改动会进入下一个Release

Git Flow 如何使用

Master/Devlop 分支

所有在Master分支上的Commit应该打上Tag,一般情况下Master不存在Commit,Devlop分支基于Master分支创建

Master/Devlop

Feature 分支

Feature分支做完后,必须合并回Develop分支, 合并完分支后一般会删点这个Feature分支,毕竟保留下来意义也不大。

Feature

Release 分支

Release分支基于Develop分支创建,打完Release分支之后,我们可以在这个Release分支上测试,修改Bug等。同时,其它开发人员可以基于Develop分支新建Feature (记住:一旦打了Release分支之后不要从Develop分支上合并新的改动到Release分支)发布Release分支时,合并Release到Master和Develop, 同时在Master分支上打个Tag记住Release版本号,然后可以删除Release分支了。

Release

Hotfix 分支

hotfix分支基于Master分支创建,开发完后需要合并回Master和Develop分支,同时在Master上打一个tag。

Hotfix

Git Flow 命令示例

创建 Devlop

git branch develop  
git push -u origin develop

开始 Feature

# 通过develop新建feaeure分支
git checkout -b feature develop
# 或者, 推送至远程服务器:
git push -u origin feature    

# 修改md文件   
git status
git add .
git commit 

完成 Feature

git pull origin develop
git checkout develop 

#--no-ff:不使用fast-forward方式合并,保留分支的commit历史
#--squash:使用squash方式合并,把多次分支commit历史压缩为一次

git merge --no-ff feature
git push origin develop

git branch -d some-feature

# 如果需要删除远程feature分支:
git push origin --delete feature   

开始 Release

git checkout -b release-0.1.0 develop

完成 Release

git checkout master
git merge --no-ff release-0.1.0
git push

git checkout develop
git merge --no-ff release-0.1.0
git push


git branch -d release-0.1.0
git push origin --delete release-0.1.0   

# 合并master/devlop分支之后,打上tag 
git tag -a v0.1.0 master
git push --tags

完成 Hotfix

git checkout master
git merge --no-ff hotfix-0.1.1
git push


git checkout develop
git merge --no-ff hotfix-0.1.1
git push

git branch -d hotfix-0.1.1
git push origin --delete  hotfix-0.1.1 


git tag -a v0.1.1 master
git push --tags

版本号管理

  • 第一位:产品大版本(与解决方案对应)(4.0开始)
  • 第二位:研发产品线版本(产品线负责人确定)
  • 第三位:研发发布版本(测试发布确认)(前端npm打包只有3位,提测及发布)
  • 第四位:提测版本(研发确定)

Git打tag、分支都使用此版本号。对外发布版程序保留前3位,第四位只在研发、测试之间同步。

实例:

  • 开发环境:4.1.1.2
  • 生产环境:4.1.1