為什麼會想要分享這個主題

一條 master 闖天下

分支開好開滿

GitLab Flow

(GitHub Flow)

我們來模擬一次開發

多個功能分支的情況

建立一個空的 git repo

mkdir test
cd test
git init
echo "Hello, ${USER}" >> master.txt
git add .
git commit -m "1st"

在 GitLab 上建立一個專案

於 git repo 中新增 remote

# 請改成自己的專案網址
git remote add origin git@gitlab.program.com.tw:jimmy.dai/git-test-20180521.git
git push -u origin master

練習時間

接下來我們一起來

快速建立三個功能分支

建立功能 A

git checkout -b feature/a master
echo "This is feature A" >> featureA.txt
git add .
git commit -m "2nd"
git push -u origin feature/a
echo "這是功能 A" >> featureA.txt
git add .
git commit -m "3rd"
git push

建立功能 B

git checkout -b feature/b master
echo "This is feature B" >> featureB.txt
git add .
git commit -m "4th"
git push -u origin feature/b
echo "這是功能 B" >> featureB.txt
git add .
git commit -m "5th"
git push

建立功能 C

git checkout -b feature/c master
echo "This is feature C" >> featureC.txt
git add .
git commit -m "6th"
git push -u origin feature/c
echo "這是功能 C" >> featureC.txt
git add .
git commit -m "7th"
git push

練習時間

功能完成時

幫分支建立 Merge Request

並且請你的伙伴來幫你看程式碼

討論和審查

1. 通知伙伴你的功能可以審查了
2. 大家一起評審及討論你的程式碼
   • 可以逐行討論
3. 你仍然可以上傳新程式碼
   • 修正錯誤及伙伴的建議

當伙伴都看過程式碼

覺得可以合併時

就回覆 LGTM

練習時間

(先別急著合併喔)

接下來假設三個 MR

都已經可以合併了

在合併分支前

需要整理分支

(Rebase and Squash)

Rebase and Squash

• 將分支 rebase 到最新的 master
• 保留有意義的 commit
• 把 commit 訊息寫的更好

git fetch --all
git checkout feature/a
git rebase -i origin/master

git rebase -i

1. pick: 要使用這個 commit
2. reword: 要修改 commit 訊息
3. squash: 要把這個 commit 合併到
   前一個 commit 中
4. fixup: 要把這個 commit 合併到
   前一個 commit 中，但是不保留訊息
5. drop: 把這個 commit 丟棄

決定如何 rebase

修改訊息

將 rebase 後的結果

push 到 GitLab 上面

(--force)

git status # 先確認自己在正確的分支
git push -f

接著在 MR 上按下 Merge

然後本地端需要 fetch

# 可以加上 --prune 同時刪除遠端沒有的分支（選用）
git fetch --all

然後把已經合併的分支刪除

git checkout master
git branch -D feature/a

更新本地的 master 分支

git checkout master
git pull

把開發中的分支移植到最新的 master 上

git checkout feature/b
git rebase master
git checkout feature/c
git rebase master

然後把移植的分支推送到遠端

git checkout feature/b
git push -f
git checkout feature/c
git push -f

練習時間

Q&A

(別走開，後面還有)

換我提問了

Q1

一定要 Squash 到剩下一個 commit 嗎?

Q2

為什麼還沒合併的功能性分支
要移植到 origin/master 上面?

小技巧

Protect Branch

• 避免主要的分支被 force push
• 只允許特定的成員 push 及 Merge

Merge commit
with semi-linear history

使用 non fast forward (--no-ff)
的方式來 Merge

但是僅在能夠透過 fast forward (--ff)
時才允許 Merge

這樣不能 Merge

這樣才能夠 Merge

參考資料

• Git 工作流程 | 阮一峰的網絡日誌
• Understanding the GitHub Flow
• GitLab Flow
• Introduction to GitLab Flow

Q&A