Quy trình merge code từ develop đến main

Quy định khi phát triển tính năng

Mỗi task làm trên một nhánh riêng tách từ develop mới nhất, rồi merge lại develop qua Merge Request trên GitLab.

Tách từ

develop đã pull mới nhất

Đặt tên

feature/PROJ-123-mo-ta-ngan

Loại khác

bugfix/, refactor/, chore/, docs/

Phạm vi

Một nhánh cho một ticket

Commit

Theo Conventional Commits: feat:, fix:, refactor:...

Duyệt

1 reviewer + CI xanh

Cách merge

Squash merge, xóa nhánh sau khi merge

Điều kiện trước khi mở và merge MR

• Nhánh tách từ develop mới nhất, tên đúng quy ước
• Đã đồng bộ develop vào nhánh, không còn conflict
• Build, lint và test chạy xanh ở máy local
• Có test cho logic mới hoặc phần đã sửa
• Đã tự review diff, không còn code debug hay secret
• Reviewer đã approve, mọi comment đã được xử lý

Lệnh

# 1. Tách nhánh từ develop mới nhất
  git fetch origin
  git checkout develop && git pull origin develop
  git checkout -b feature/PROJ-123-dang-nhap-google
  
  # 2. Làm việc, commit nhỏ và rõ nghĩa
  git add .
  git commit -m "feat(auth): thêm đăng nhập Google"
  
  # 3. Đồng bộ develop thường xuyên (ít nhất mỗi ngày)
  git fetch origin
  git rebase origin/develop
  
  # 4. Đẩy nhánh, rồi tạo Merge Request trên GitLab vào develop
  git push -u origin feature/PROJ-123-dang-nhap-google
  # sau khi rebase, nhánh đã push cần:
  # git push --force-with-lease
  # GitLab → Merge requests → New merge request
  #   Source: feature/PROJ-123-dang-nhap-google
  #   Target: develop
  #   Title:  feat(auth): đăng nhập Google [PROJ-123]
  
  # 5. Sau khi MR được merge, dọn nhánh
  git checkout develop && git pull origin develop
  git branch -d feature/PROJ-123-dang-nhap-google
  git push origin --delete feature/PROJ-123-dang-nhap-google

Mục tiêu

Đưa các tính năng đã tích hợp ổn định trên develop lên staging để QA và khách hàng nghiệm thu.

Mở MR

Maintainer, trên GitLab

Duyệt

1 reviewer + CI xanh

Cách merge

Merge commit

Sau merge

Tự động deploy lên môi trường staging

Điều kiện trước khi merge

• Các MR feature đã merge vào develop và review xong
• CI (build, lint, unit test) xanh trên develop
• Không còn conflict với staging
• Đã chốt danh sách tính năng đưa lên staging
• Migration DB (nếu có) đã được kiểm tra

Lệnh

# 1. Cập nhật nhánh nguồn và đích
  git fetch origin
  git checkout develop && git pull origin develop
  git checkout staging && git pull origin staging
  
  # 2. Thử merge cục bộ để phát hiện conflict
  git merge --no-ff develop
  # xử lý conflict nếu có, rồi hủy nếu chỉ thử:
  # git merge --abort
  
  # 3. Tạo Merge Request trên GitLab (khuyến nghị)
  # GitLab → Merge requests → New merge request
  #   Source: develop
  #   Target: staging
  #   Title:  Merge develop into staging

Mục tiêu

Phát hành bản đã được nghiệm thu trên staging lên production.

Mở MR

Maintainer, trên GitLab

Duyệt

CI xanh

Cách merge

Merge commit

Sau merge

Deploy production + Thông báo build thành công từ telegram

Điều kiện trước khi merge

• QA / UAT trên staging đã sign-off
• Migration DB (nếu có) đã được kiểm tra
• Biến môi trường, secret và migration production đã sẵn sàng

Lệnh

# Tạo Merge Request trên GitLab: staging → main
  # GitLab → Merge requests → New merge request
  #   Source: staging
  #   Target: main
  #   Title:  Merge staging into main

Mục tiêu

Đưa merge commit của main về lại develop và staging để ba nhánh không bị lệch lịch sử.

Khi nào

Ngay sau khi deploy production thành công

Cách merge

Merge commit từ main

Thứ tự

main → staging → develop

Việc cần làm

• Production hoạt động ổn định sau deploy
• Merge main về staging
• Merge staging (hoặc main) về develop
• Thông báo team: develop đã cập nhật, kéo code mới

Lệnh

git fetch origin
  
  # main -> staging
  git checkout staging && git pull origin staging
  git merge --no-ff origin/main
  git push origin staging
  
  # main -> develop
  git checkout develop && git pull origin develop
  git merge --no-ff origin/main
  git push origin develop

Mục tiêu

Sửa lỗi khẩn cấp trên production mà không phải chờ cả chu kỳ develop → staging → main.

Tạo nhánh

hotfix/* từ main

Duyệt

Tech lead + CI xanh

Đích

main trước, sau đó đồng bộ về staging và develop

Việc cần làm

• Tạo hotfix từ main, chỉ chứa bản sửa lỗi
• Tạo MR vào main trên GitLab, test nhanh và merge
• Deploy bản hotfix lên production
• Merge main về staging và develop

Lệnh

git checkout main && git pull origin main
  git checkout -b hotfix/fix-login-500
  
  # ...sửa lỗi, commit...
  git push -u origin hotfix/fix-login-500
  # GitLab → Merge requests → New merge request
  #   Source: hotfix/fix-login-500
  #   Target: main
  #   Title:  Hotfix: lỗi 500 khi đăng nhập
  
  # sau khi merge: đồng bộ main về staging, develop (xem tab 4)
  git checkout main && git pull origin main