Flow tham khảo: Git flow of Framgia Viet Nam
- Đã tạo Central Repository (Nguồn trung tâm) trên Github（hoặc Bitbucket）。
- Branch mặc định của Central Repository là master。
- Lập trình viên có thể fork (tạo nhánh) đối với Central Repository。
- Đã quyết định người review và người có quyền merge。
- Mỗi pull-request tương ứng với một ticket và chỉ có một commit trong đó。
- Nội dung của commit là
refs [Loại ticket] #[Số ticket] [Nội dung ticket]（Ví dụ:refs bug #1234 Sửa lỗi cache）。 - Tại môi trường local(trên máy lập trình viên), tuyệt đối không được thay đổi code khi ở branch master。Nhất định phải thao tác trên branch khởi tạo để làm task。
-
Trên Github (Bitbucket), fork Central Repository về tài khoản của mình（repository ở tài khoản của mình sẽ được gọi là Forked Repository）。
-
Clone (tạo bản sao) Forked Repository ở môi trường local。Tại thời điểm này, Forked Repository sẽ được tự động đăng ký dưới tên là
origin。$ git clone [URL của Forked Repository]
-
Truy cập vào thư mục đã được tạo ra sau khi clone, đăng ký Central Repository dưới tên
upstream。$ cd [thư mục được tạo ra] $ git remote add upstream [URL của Central Repository]
Từ đây, Central Repository và Forked Repository sẽ được gọi lần lượt là upstream và origin。
-
Đồng bộ hóa branch master tại local với upstream。
$ git checkout master $ git pull upstream master
-
Tạo branch để làm task từ branch master ở local. Tên branch là số ticket của task（Ví dụ:
task/1234）。$ git checkout master # <--- Không cần thiết nếu đang ở trên branch master $ git checkout -b task/1234 -
Tiến hành làm task（Có thể commit bao nhiêu tùy ý）。
-
Trường hợp đã tạo nhiều commit trong quá trình làm task、tại 5. trước khi push phải dùng rebase -i để hợp các commit lại thành 1 commit duy nhất。
$ git rebase -i [Giá trị hash của commit trước commit đầu tiên trong quá trình làm task] -
Quay trở về branch master ở local và lấy code mới nhất về
$ git checkout master $ git pull upstream master
-
Quay trở lại branch làm task, sau đó rebase với branch master。
$ git checkout task/1234 $ git rebase master
Trường hợp xảy ra conflict trong quá trình rebase、hãy thực hiện các thao tác của mục「Khi xảy ra conflict trong quá trình rebase」。
-
Push code lên origin。
$ git push origin task/1234
-
Tại origin trên Github（Bitbucket）、từ branch
task/1234đã được push lên hãy gửi pull-request đối với branch master của upstream. -
Hãy gửi link URL của trang pull-request cho reviewer trên chatwork để tiến hành review code。
9.1. Trong trường hợp reviewer có yêu cầu sửa chữa, hãy thực hiện các bước 3. 〜 6.。
9.2 push -f (push đè hoàn toàn lên code cũ) đối với remote branch làm task。
$ git push origin task/1234 -f
9.3 Tiếp tục gửi lại URL cho reviewer trên chatwork để tiến hành việc review code。
-
Nếu trên 2 người reviewer đồng ý với pull-request, người reviewer cuối cùng sẽ thực hiện việc merge pull-request。
-
Quay trở lại 1。
Khi xảy ra conflict trong quá trình rebase, sẽ có hiển thị như dưới đây (tại thời điểm này sẽ bị tự động chuyển về một branch vô danh)
$ git rebase master
First, rewinding head to replay your work on top of it...
Applying: refs #1234 Sửa lỗi cache
Using index info to reconstruct a base tree...
Falling back to patching base and 3-way merge...
Auto-merging path/to/conflicting/file
CONFLICT (add/add): Merge conflict in path/to/conflicting/file
Failed to merge in the changes.
Patch failed at 0001 refs #1234 Sửa lỗi cache
The copy of the patch that failed is found in:
/path/to/working/dir/.git/rebase-apply/patch
When you have resolved this problem, run "git rebase --continue".
If you prefer to skip this patch, run "git rebase --skip" instead.
To check out the original branch and stop rebasing, run "git rebase --abort".-
Hãy thực hiện fix lỗi conflict thủ công（những phần được bao bởi <<< và >>> ）。 Trong trường hợp muốn dừng việc rebase lại, hãy dùng lệnh
git rebase --abort。 -
Khi đã giải quyết được tất cả các conflict, tiếp tục thực hiện việc rebase bằng:
$ git add . $ git rebase --continue