這節介紹的Gitflow
工作流借鑑自在nvie的Vincent Driessen。
Gitflow
工作流定義了一個圍繞專案釋出的嚴格分支模型。雖然比功能分支工作流複雜幾分,但提供了用於一個健壯的用於管理大型專案的框架。
Gitflow
工作流沒有用超出功能分支工作流的概念和命令,而是為不同的分支分配一個很明確的角色,並定義分支之間如何和什麼時候進行互動。除了使用功能分支,在做準備、維護和記錄釋出也使用各自的分支。當然你可以用上功能分支工作流所有的好處:Pull Requests
、隔離實驗性開發和更高效的協作。
工作方式
Gitflow
工作流仍然用中央倉庫作為所有開發者的互動中心。和其它的工作流一樣,開發者在本地工作並push
分支到要中央倉庫中。
歷史分支
相對使用僅有的一個master
分支,Gitflow
工作流使用2個分支來記錄專案的歷史。master
分支儲存了正式釋出的歷史,而develop
分支作為功能的整合分支。這樣也方便master
分支上的所有提交分配一個版本號。
剩下要說明的問題圍繞著這2個分支的區別展開。
功能分支
每個新功能位於一個自己的分支,這樣可以push
到中央倉庫以備份和協作。但功能分支不是從master
分支上拉出新分支,而是使用develop
分支作為父分支。當新功能完成時,合併回develop
分支。新功能提交應該從不直接與master
分支互動。
注意,從各種含義和目的上來看,功能分支加上develop
分支就是功能分支工作流的用法。但Gitflow
工作流沒有在這裡止步。
釋出分支
一旦develop
分支上有了做一次釋出(或者說快到了既定的釋出日)的足夠功能,就從develop
分支上fork
一個釋出分支。新建的分支用於開始釋出迴圈,所以從這個時間點開始之後新的功能不能再加到這個分支上 —— 這個分支只應該做Bug
修復、文件生成和其它面向釋出任務。一旦對外發布的工作都完成了,釋出分支合併到master
分支並分配一個版本號打好Tag
。另外,這些從新建釋出分支以來的做的修改要合併回develop
分支。
使用一個用於釋出準備的專門分支,使得一個團隊可以在完善當前的釋出版本的同時,另一個團隊可以繼續開發下個版本的功能。
這也打造定義良好的開發階段(比如,可以很輕鬆地說,『這周我們要做準備釋出版本4.0』,並且在倉庫的目錄結構中可以實際看到)。
常用的分支約定:
用於新建釋出分支的分支: develop
用於合併的分支: master
分支命名: release-* 或 release/*
維護分支
維護分支或說是熱修復(hotfix
)分支用於生成快速給產品釋出版本(production releases
)打補丁,這是唯一可以直接從master
分支fork
出來的分支。修復完成,修改應該馬上合併回master
分支和develop
分支(當前的釋出分支),master
分支應該用新的版本號打好Tag
。
為Bug
修復使用專門分支,讓團隊可以處理掉問題而不用打斷其它工作或是等待下一個釋出迴圈。你可以把維護分支想成是一個直接在master
分支上處理的臨時釋出。
示例
下面的示例演示本工作流如何用於管理單個釋出迴圈。假設你已經建立了一箇中央倉庫。
建立開發分支
第一步為master
分支配套一個develop
分支。簡單來做可以本地建立一個空的develop
分支,push
到伺服器上:
git branch develop
git push -u origin develop
以後這個分支將會包含了專案的全部歷史,而master
分支將只包含了部分歷史。其它開發者這時應該克隆中央倉庫,建好develop
分支的跟蹤分支:
git clone ssh://user@host/path/to/repo.git
git checkout -b develop origin/develop
現在每個開發都有了這些歷史分支的本地拷貝。
小紅和小明開始開發新功能
這個示例中,小紅和小明開始各自的功能開發。他們需要為各自的功能建立相應的分支。新分支不是基於master
分支,而是應該基於develop
分支:
git checkout -b some-feature develop
他們用老套路新增提交到各自功能分支上:編輯、暫存、提交:
git status
git add
git commit
小紅完成功能開發
新增了提交後,小紅覺得她的功能OK了。如果團隊使用Pull Requests
,這時候可以發起一個用於合併到develop
分支。否則她可以直接合併到她本地的develop
分支後push
到中央倉庫:
git pull origin develop
git checkout develop
git merge some-feature
git push
git branch -d some-feature
第一條命令在合併功能前確保develop
分支是最新的。注意,功能決不應該直接合併到master
分支。衝突解決方法和集中式工作流一樣。
小紅開始準備釋出
這個時候小明正在實現他的功能,小紅開始準備她的第一個專案正式釋出。像功能開發一樣,她用一個新的分支來做釋出準備。這一步也確定了釋出的版本號:
git checkout -b release-0.1 develop
這個分支是清理髮布、執行所有測試、更新文件和其它為下個釋出做準備操作的地方,像是一個專門用於改善釋出的功能分支。
只要小紅建立這個分支並push
到中央倉庫,這個釋出就是功能凍結的。任何不在develop
分支中的新功能都推到下個釋出迴圈中。
小紅完成釋出
一旦準備好了對外發布,小紅合併修改到master
分支和develop
分支上,刪除釋出分支。合併回develop
分支很重要,因為在釋出分支中已經提交的更新需要在後面的新功能中也要是可用的。另外,如果小紅的團隊要求Code Review
,這是一個發起Pull Request
的理想時機。
git checkout master
git merge release-0.1
git push
git checkout develop
git merge release-0.1
git push
git branch -d release-0.1
釋出分支是作為功能開發(develop
分支)和對外發布(master
分支)間的緩衝。只要有合併到master
分支,就應該打好Tag
以方便跟蹤。
git tag -a 0.1 -m "Initial public release" master
git push --tags
Git
有提供各種勾子(hook
),即倉庫有事件發生時觸發執行的指令碼。可以配置一個勾子,在你push
中央倉庫的master
分支時,自動構建好對外發布。
終端使用者發現Bug
對外發布後,小紅回去和小明一起做下個釋出的新功能開發,直到有終端使用者開了一個Ticket
抱怨當前版本的一個Bug
。為了處理Bug
,小紅(或小明)從master
分支上拉出了一個維護分支,提交修改以解決問題,然後直接合並回master
分支:
git checkout -b issue-#001 master
# Fix the bug
git checkout master
git merge issue-#001
git push
就像釋出分支,維護分支中新加這些重要修改需要包含到develop
分支中,所以小紅要執行一個合併操作。然後就可以安全地刪除這個分支了:
git checkout develop
git merge issue-#001
git push
git branch -d issue-#001
下一站
到了這裡,但願你對集中式工作流、功能分支工作流和Gitflow
工作流已經感覺很舒適了。你應該也牢固的掌握了本地倉庫的潛能,push
/pull
模式和Git
健壯的分支和合並模型。
記住,這裡演示的工作流只是可能用法的例子,而不是在實際工作中使用Git
不可違逆的條例。所以不要畏懼按自己需要對工作流的用法做取捨。不變的目標就是讓Git
為你所用。
譯註
自己理解粗淺,譯文原始碼在GitHub
上,翻譯中不足和不對之處,歡迎建議(提交Issue)和指正(Fork後提交程式碼)!
打賞支援我翻譯更多好文章,謝謝!
打賞譯者
打賞支援我翻譯更多好文章,謝謝!
任選一種支付方式