Skip to content

Latest commit

 

History

History
486 lines (134 loc) · 8.7 KB

branching-model.md

File metadata and controls

486 lines (134 loc) · 8.7 KB

Git分支模型及版本控制

如下图所示，Vincent Driessen分支模型是一个团队开发时git分支，版本发布，bug修正的策略。这个流程的完整实施需要灵活使用多种指令，不过我们可以采用git-flow来将这个过程变得更加容易一些。 这里先介绍各个分支的含义，通过实例介绍各个指令。

1. 分支介绍

2.1 主分支

Git里面存在两个平行的主分支

  • master ： 一个始终处于production-ready状态的主分支

  • develop ： 面向下一个release的最新开发状态分支，各种自动nightly builds在这里执行。

当develop分支里的内容达到一个可以稳定发布版本的时候，所有点改动都会被合并到master分支，然后形成一个特定的版本号。

2.2 其他分支

团队成员使用一切其他分支来进行并发协作，这些分支生命周期有限，最终将被删除。这些分支都有明确的目的，它们从哪些分支分支出来，最终合并到哪个分支，都有明确的定义。

2.2.1 Feature分支

为了开发未来功能的特性分支，当开发一个新特性时，其准备发布的版本可能是未知的。只要特性在开发，这个分支就存在，最终可能会被merge回develop，或者直接被删除。

  • 从哪来：develop

  • 到哪去：develop

  • 命名：除了master, develop, release-, or hotfix- 的任何名称

另外，feature分支一般只在开发者个人repos里面，并不会被提交到origin。

新建Feature分支指令

$ git flow feature start feature-name

结束Feature分支指令

$ git flow feature finish feature-name

2.2.2 Release分支

Release分支用来准备下一个产品发布分支，这个分支上可以做一些bug修正和版本号标记。而develop分支则可以用于接受下一个大的发布的Feature。从develop里分出release分支的关键时刻是develop分支几乎已经达到新发布版本预期效果的状态时。至少所有面向新发布版本的Feature需要merge回这个develop分支。 而面向再后面版本的Feature最好等release分支出来以后再合并到develop里面。在Release分支切出来以后，是禁止加入大的Feature的，这些Feature只能merge进入develop。

  • 从哪来：develop

  • 到哪去：develop 或 master

  • 命名：release-*

当这个Release分支即将成为下一个正式发布版时，需要做如下工作

  1. Release分支合并回master分支

  2. 被提交到master上的提交需要添加一个方便未来引用的版本号。

  3. 最后在Release分支里面进行的修改需要被合并回develop分支，这样未来的Release包括这些bug修正。

当最终完成分支以后，可以将Release分支删除，因为不再需要他们了。

2.2.3 Hotfix分支

当有重要bug需要立即修正时，从master分出一个hotfix分支，修正以后再合并回master和develop分支。

  • 从哪来：master

  • 到哪去：develop 或 master

  • 命名：hotfix-*

2. 安装git-flow

2.1 Ubuntu Linux

$sudo apt-get install -y git-flow

2.2 Mac OS

$brew install git-flow

2.3 Windows

2.3.1 下载并安装git

点击Windows Git官方网址，点击“Download”

下载完成后，请保持git的默认安装
例如：64位系统安装目录为（C:\Program Files (x86)\Git）

2.3.2 下载相应工具

将三个文件夹解压

可以在util-linux-ng-2.14.1-bin\bin找到 getopt.exe

可以在libintl-0.14.4-bin\bin找到 libintl3.dll

可以在libiconv-1.9.2-1-bin\bin找到 libiconv2.dll

将这三个文件（getopt.exe和libintl3.dll和libiconv2.dll）复制到git安装目录下的bin目录中（C:\Program Files (x86)\Git\bin）

2.3.3 克隆git flow项目

请使用git bash进行克隆gitflow项目(吐槽，git bash居然不能粘贴复制，自己一点点敲吧……)

$git clone --recursive git://github.com/nvie/gitflow.git

克隆完成后，运行cmd

在cmd中，进入gitflow项目中的contrib目录下

>cd gitflow\contrib

安装gitflow到git的安装目录下

>msysgit-install.cmd "C:\Program Files (x86)\Git"

如果安装成功，则会提示诸如“复制了 1 个文件”之类提示信息

2.3.4 测试git flow是否安装成功

创建测试目录，使用git bash进入测试目录，执行

git flow init

如果安装成功，则会出现“No branch exist yet”提示信息，说明在windows下的git flow安装成功

3. 初始化项目相关操作

可以在一个目录里执行git flow init，从而初始化项目，并自动生成多个分支。如果这时候执行git branch，会看到如下项目自动处于develop分支

$ git flow init

develop分支是日常工作分支，而master分支则仅保存可发布状态的版本。 所以这个时候提交代码需要采用如下指令

$ git push origin develop

4. Feature分支相关操作

git-flow使得同时在多个Feature上面工作变得非常方便。

4.1 Start Feature

$ git flow feature start f1

如图所示，在feature初始化以后，我们可以通过git branch查看到当前处于feature/f1这个分支，而通过git flow feature这个指令我们可以看到目前总共有一个feature分支f1

我们可以再创一个f2分支，并查看如下

4.2 Finish Feature

$ git flow feature finish f1

执行结果如图所示，我们注意到f1的内容已经被合并到develop分支，而本地的f1分支也被删掉，最后项目切换到了develop分支

4.3 指令总结

总结一下，要list/start/finish Feature分支，可以使用如下指令，这里的[base]参数必须是develop分支上的一个commit

git flow feature

git flow feature start <name> [<base>]

git flow feature finish <name>

要push/pull 远端服务器的一个Feature分支，可以使用如下执行

git flow feature publish <name>

git flow feature pull <remote> <name>

5. Release分支相关操作

5.1 Start Release

$ git flow release start 0.1.0

结果如下图所示，我们看到创建了一个release/0.1.0分支，并且切换到这个分支，

5.2 Finish Release

$ git flow release finish 0.1.0

如图所示，这个指令完成了如下事情

  • 将release/0.1.0分支合并进master

  • 在release上tag v0.1.0

  • 删除本地的release/0.1.0分支删除

  • 最后切换到master分支

5.3 指令总结

总结一下，要list/start/finish Release分支，则使用如下指令，这里的[base]参数必须是develop分支上的一个commit

git flow release

git flow release start <release> [<base>]

git flow release finish <release>

6. Hotfix 分支相关操作

因为我们始终保持master分支的生产状态，所以很容易基于生产状态fix一些issue。

6.1 Start Hotfix

$ git flow hotfix start 0.1.1

结果如下显示，这个hotfix是基于master产生的，并且项目也切到了这个分支

6.2 Finish Hotfix

$ git flow hotfix finish 0.1.1

结果如下显示，hotfix被合并到master

6.3 指令总结

要list/start/finish Hotfix分支，则使用如下指令，这里的[base]参数必须是develop分支上的一个commit

git flow hotfix

git flow hotfix start <release> [<base>]

git flow hotfix finish <release>

参考文献

  1. Vincent Driessen，A successful Git branching model, January 05, 2010

  2. Jeff Kreeftmeijer, Using git-flow to automate your git branching workflow, August 29, 2010

  3. Gitflow @Github