概念

產品版本

項目/子項目所定義的版本，兩節：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，以追蹤各環境和不同版本部署物的對應關系。

假設場景

開發流程