07-Git_Flow使用方法

  • http://www.berlinix.com/it/gitflow.php

    http://www.berlinix.com/it/gitflow.php

    http://www.berlinix.com/it/git.php

    http://www.berlinix.com/it/git.php

    gitflow分支管理模型 #

    gitflow的分支类型：

    • master分支（1个）
    • develop分支（1个）
    • feature分支。同时存在多个。
    • release分支。同一时间只有1个，生命周期很短，只是为了发布。
    • hotfix分支。同一时间只有1个。生命周期较短，用了修复bug或小粒度修改发布。

    在这个模型中，master和develop都具有象征意义。master分支上的代码总是稳定的（stable build），随时可以发布出去。develop上的代码总是从feature上合并过来的，可以进行Nightly Builds，但不直接在develop上进行开发。当develop上的feature足够多以至于可以进行新版本的发布时，可以创建release分支。

    release分支基于develop，进行很简单的修改后就被合并到master，并打上tag，表示可以发布了。紧接着release将被合并到develop；此时develop可能往前跑了一段，出现合并冲突，需要手工解决冲突后再次合并。这步完成后就删除release分支。

    当从已发布版本中发现bug要修复时，就应用到hotfix分支了。hotfix基于master分支，完成bug修复或紧急修改后，要merge回master，打上一个新的tag，并merge回develop，删除hotfix分支。

    由此可见release和hotfix的生命周期都较短，master/develop虽然总是存在但却不常使用。

    以上就是gitflow的基本概念了。下面是nvie（gitflow的提出者，一个荷兰人！） A successful Git branching model（发布于2010年月5日）一文的笔记。

    从右看起：

    • 时间轴。
    • feature（玫红）。主要是自己玩了，差不多的时候要合并回develop去。从不与master交互。
    • develop（黄色）。主要是和feature以及release交互。
    • release（绿色）。总是基于develop，最后又合并回develop。当然对应的tag跑到master这边去了。
    • hotfix（红色）。总是基于master，并最后合并到master和develop。
    • master（蓝色）。没有什么东西，仅是一些关联的tag，因从不在master上开发。

    接下来nvie说道自己喜爱git，因git改变了人们对合并/分支（merge/branches）的看法。从集中式的代码管理工具过来的人感到释放了（beware of merge conflicts, they bite you，注意合并冲突，它们会跳出来咬你！）。

    gitflow实例 #

    安装gitflow：

    $ git clone --recursive git://github.com/nvie/gitflow.git
$ cd gitflow/
$ sudo make install
$ ls /usr/local/bin/git-flow
/usr/local/bin/git-flow

    到项目根目录下执行gitflow，因为之前修改没有commit，所以gitflow初始化失败：

    $ git flow init
fatal: Working tree contains unstaged changes. Aborting.

    commit后再次进行gitflow初始化：

    $ git commit -a -m "update Bash"
[master 8f5b874] update Bash
 4 files changed, 71 insertions(+), 5 deletions(-)

[bailing@zhuji zhuji]$ git flow init

Which branch should be used for bringing forth production releases?
   - master
Branch name for production releases: [master] 
Branch name for "next release" development: [develop] 

How to name your supporting branch prefixes?
Feature branches? [feature/] 
Release branches? [release/] 
Hotfix branches? [hotfix/] 
Support branches? [support/] 
Version tag prefix? []

    一路回车下来，各个分支名都按默认的设置。最后，当前分支已经被切换到了develop：

    $ git branch
* develop
  master

    建立一个新的feature。git flow新建了功能分支feature/blog_builder，并在develop的基础上checkout了新分支：

    $ git flow feature start blog_builder
$ git branch
  develop
* feature/blog_builder
  master

    开发完成后执行如下命令：

    $ git flow feature finish blog_builder
Summary of actions:
- The feature branch 'feature/blog_builder' was merged into 'develop'
- Feature branch 'feature/blog_builder' has been removed
- You are now on branch 'develop'

    正如这条命令的总结所言，git flow为我们做了3件事：

    • 把feature/blog_builder合并到了develop。
    • 删除了feature/blog_builder分支。
    • 切换回develop分支。

    接下来发布一个正常的版本：

    $ git flow release start v0.5

    一旦需要发布的版本确认无误可以发布后，执行命令：

    $ git flow release finish v0.5
summary of actions:
- Latest objects have been fetched from 'origin'
- Release branch has been merged into 'master'
- The release was tagged 'v0.5'
- Release branch has been back-merged into 'develop'
- Release branch 'release/v0.5' has been deleted

    注意release/v0.5被合并到了master和develop分支，并打了个v0.5的tag，然后被删除，最后切换回了develop分支：

    $ git branch
* develop
  master

    发布时只需将tag为v0.5的版本checkout出来部署即可：

    $ git tag
v0.5

    当上线后发现v0.5的bug，可以进行hotfix：

    $ git flow hotfix start v0.5.1

    此时gitflow从master分支上拉出一个hotfix/v0.5.1的分支，接下来在新分支上修改bug。最后执行命令：

    $ git flow hotfix finish v0.5.1

    这样hotfix/v0.5.1被merge到master/develop分支，打好v0.5.1这个tag，删除这个分支，切换回develop分支。

    之后又是新一次的轮回，启动正常的feature开发。

    -—————————-

    Git（the stupid content tracker）是一个源自Linux内核项目的源码管理工具。和传统的CVS、SVN不同，git是一个分布式源码管理工具。

    Git命令简单说明
    git init初始化一个本地的代码仓库。
    git clone从远程复制一个代码仓库。
    git configgit选项设置。
    git add添加文件/目录。
    git commit提交修改。
    git status显示工作目录的状态以及缓冲区内的快照。
    git log已提交快照的日志。
    git branch创建分支。
    git checkout迁出/拉出/切换到一个分支。
    git merge合并分支。
    git revert撤销commit快照。
    git reset撤销本地工作目录的修改。
    git clean删除代码仓库以外的文件。
    git remote管理远程git。
    git fetch从远程获取分支。
    git pull从远程获取分支。
    git push把代码推到远程分支。

    基本概念 #

    文件状态 #

    Git仓库中的文件有几种状态：

    • untracked - 还没添加到仓库中。
    • unmodified - 自上次提交以来，文件未曾修改过。
    • modified - 文件修改了还没提交。
    • staged - 文件提交到了暂存区中。一旦执行git commit就会转换为unmodified状态。

    Git暂存区（Staged Area）的意思是：你把一个文件托付给Git跟踪（git add），然后又修改了它，此时这个文件就位于暂存区了。暂存区内的文件几乎只做一件事：等待你执行git commit，把它提交。

    快照（snapshot） #

    Git与其他版本控制系统的区别在于：Git只关心文件是否变化，而不关心文件内容的变化。大多数版本控制系统都会忠实地记录版本间的文件差异（diff），但Git不关心这些具体差异（哪一行有什么变动），Git只关心哪些文件修改了哪些没有修改，修改了的文件直接复制形成新的blob（这就是所谓的快照snapshot）。当你需要切换到或拉出一个分支时，Git就直接加载当时的文件快照即可，这就是Git快的原因。说起来，这也是用空间换取时间的经典案例。

    从这个角度看，Git更像是一个小型文件系统，并在这个系统上提供一系列的工具来辅助开发。

    Git的地理观 #

    Git是一个分布式的版本控制系统，因此没有所谓的中心。粗略来看Git可分为本地库（local repository）和远程库（remote repository），细致地看可分为以下几个部分：

    • Working Directory - 工作目录。Git仓库位于工作目录之下，工作目录下的文件有加入Git仓库（tracked）和没加入Git仓库（untracked）的区别。
    • Stage Area - 暂存区。如上所述，已加入Git仓库并被修改（尚未提交）的文件。
    • Local Repository - 本地仓库。
    • Remote Repository - 远程仓库。

    文件通常是：加入Git仓库（git add）-> 修改后即位于暂存区 -> 提交到本地库（git commit） -> 推送到远程库（git push）。

    origin/master #

    这里主要笔记一些在Git上下文中经常遇见的术语。origin/master指远程仓库origin的master分支。

    远程仓库/分支

    这样的形式。虽然Git是分布式的系统，但通常把git clone的源头叫做origin，origin也被视为中心仓库（Central Repository）。

    git入门 #

    创建目录，并用git init初始化：

    $ mkdir learn-git && cd learn-git
$ git init
Initialized empty Git repository in /tmp/learn-git/.git/

    从git init输出可知，git创建了一个名为.git的隐藏目录。

    创建一个文件，并用git add添加到仓库，用git commit提交：

    $ echo "hello git" > README.txt
$ git add .
$ git commit -m "readme file"
[master (root-commit) cd27ac1] readme file
 1 file changed, 1 insertion(+)
 create mode 100644 README.txt

    接下来对已提交文件做一些修改，并新添加一个文件：

    $ echo "learn files here" >> README.txt
$ cp ~/.vimrc .

    用git diff查看文件差异（每次commit前应该先diff对比差异详情）：

    $ git diff
diff --git a/README.txt b/README.txt
index 8d0e412..0219596 100644
--- a/README.txt
+++ b/README.txt
@@ -1 +1,2 @@
 hello git
+learn files here

    差异对比可以用git diff --cached保存下来（如此差异则不输出到屏幕）。

    用git status查看git仓库状态：

    $ git status
# On branch master
# Changes not staged for commit:
#   (use "git add <file>..." to update what will be committed)
#   (use "git checkout -- <file>..." to discard changes in working directory)
#
#       modified:   README.txt
#
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#
#       .vimrc
no changes added to commit (use "git add" and/or "git commit -a")

    这里显示README.txt被修改了，而.vimrc则等待添加。接下来，我们将.vimrc添加到git仓库中，且将所有修改一并提交（git commit -a）：

    $ git commit -a -m "update readme && add vimrc"
[master f6162f0] update readme && add vimrc
 2 files changed, 123 insertions(+)
 create mode 100755 .vimrc

    git log输出git日志，包括提交编号（如"f6162f04170e3665bc03744e43f764c903e4e38d"这样的字串）、提交者、提交日期和提交日志。

    git log的其他输出：

    $ git log -p                    # 详细日志，并输出到分页程序
$ git log --stat --summary

    美化git log输出

    $ git log --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --

    修改全局配置：

    $ git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --"
$ git lg

    管理分支 #

    创建一个分支：

    $ git branch exp

    查看当前git仓库的所有分支：

    $ git branch
  exp
* master

    切换到exp分支：

    $ git checkout exp
Switched to branch 'exp'

    修改文件，并提交：

    $ echo "start branch: exp" >> README.txt 
$ git commit -a -m "modified readme in exp branch"
[exp 2e825a4] modified readme in exp branch
 1 file changed, 1 insertion(+)

    切换回master分支：

    $ git checkout master
Switched to branch 'master'

    在master分支检查文件，可见exp分支的修改并没影响到master分支（注意，在exp分支的修改都已提交；如果没有提交，则切换回master分支会看到文件已变）。接下来我们制造一个冲突：

    $ echo "return branch: master" >> README.txt                    
$ git commit -a -m "modified readme in master branch"
[master 8dd9fb2] modified readme in master branch
 1 file changed, 1 insertion(+)

    用git merge exp合并分支：

    $ git merge exp
Auto-merging README.txt
CONFLICT (content): Merge conflict in README.txt
Automatic merge failed; fix conflicts and then commit the result.

    从git输出可见，git尝试自动合并但失败了，因此提示需要解决冲突再提交

    用git diff查看差异，且差异文件被修改：

    $ git diff
...
$ cat README.txt 
hello git
learn files here
<<<<<<< HEAD
return branch: master
=======
start branch: exp
>>>>>>> exp

    手工解决冲突并再次提交：

    (edit file)
$ git commit -a -m "do merge"

    接下来，可以删除exp分支：

    $ git branch -d exp
Deleted branch exp (was 2e825a4).

    git branch -d删除分支时会检查分支是否完全合并到主干，如果不是，则会删除失败，并提示需要合并：

    $ git branch exp                        # 建立exp分支
$ git checkout exp                      # 切换到exp分支
$ echo "exp again" >> README.txt        # 修改并提交
$ git commit -a -m "exp again"
[exp 868e68c] exp again
 1 file changed, 1 insertion(+)
$ git checkout master                   # 切换回master
Switched to branch 'master'
$ git branch -d exp                     # 删除失败
error: The branch 'exp' is not fully merged.
If you are sure you want to delete it, run 'git branch -D exp'.

    可以用git branch -D exp忽略修改，完全删除分支：

    $ git branch -D exp
Deleted branch exp (was 868e68c).

    查看远端git #

    基础命令是：git remote show, git remote show X。

    $ git remote show
origin
web

    查看GitHub默认设置的origin

    $ git remote show origin
* remote origin
  Fetch URL: git@github.com:berlinix/blog.git
  Push  URL: git@github.com:berlinix/blog.git
  HEAD branch: master
  Remote branch:
    master tracked
  Local branch configured for 'git pull':
    master merges with remote master
  Local ref configured for 'git push':
    master pushes to master (fast-forwardable)

    git命令快查 #

    以下列出一些常用的git命令

    命令说明
    基础操作
    git init初始化git仓库
    git add X添加X文件/路径到git仓库
    git commit -m “COMMENTS”提交更新
    分支管理
    git branch X创建一个名为X的分支
    git checkout X切换到X分支
    git merge X自动合并X分支
    git branch -d X删除X分支，需要先merge
    git branch -D X强制删除X分支，忽略其修改，无须先merge
    与远程git交互
    git remote show显示远程git仓库
    git remote show X显示远程git一个名为X的仓库
    git push origin master更新提交到GitHub

    Git日常问题 #

    撤销commit #

    刚与master合并并提交后就后悔了现在要做的是撤销commit（revoke/undo merge/commit）。

    查看当前所在分支：

    $ git branch
  bs3
* coin
  dev
  master

    查看日志：

    $ git log --oneline
9b7ba39 merged with master
73a66e8 update FAQ

    用以下2个命令来撤销提交（把COMMIT_SHA替换为实际的SHA值；把HEAD~N中的N替换为一个数字，表示回退几步）：

    $ git reset --hard COMMIT_SHA
$ git reset --hard HEAD~N

    例如回退到合并前：

    $ git reset --hard 73a66e8
HEAD is now at 73a66e8 update FAQ

    回退后发现不对，因为现在这个commit还是在master中的（在merge之前master已经走的太远），赶紧再次reset到merge时的状态：

    $ git reset --hard 9b7ba39
HEAD is now at 9b7ba39 merged with master

    如此一来就是就是merge后commit之前的状态。接下来就是要完成undo merge（已经undo commit了）：

    $ git revert -m 1 9b7ba39

    这下就彻底回到merge前了，以防万一再次检查：

    $ git diff --name-status master..coin

    看起来没什么问题了，检查下日志：

    $ git log --oneline
2691516 Revert "merged with master"
9b7ba39 merged with master
73a66e8 update FAQ

    用git找回已删除文件 #

    首先找到与目标文件相关的最后一次commit。如果目标文件没有出现在HEAD commit中，那么在这次commit时，文件就被删除了：

    $ git rev-list -n 1 HEAD -- htdocs/myfile.php
1e8182f58dc038c8e6bc2025e8430f463d372030

    接下来就是恢复工作了：

    $ git checkout 1e8182f58dc038c8e6bc2025e8430f463d372030^ -- htdocs/myfile.php

    合并分支的部分文件 #

    有时候只想合并分支里的部分文件，而不是整个分支，可以用这个命令：

    git checkout BRANCH FILE ...

    例如，从test_branch分支中合并file_modified文件：

    $ git checkout test_branch file_modified

    参考Git Tip: How to “Merge” Specific Files from Another Branch。