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

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ở PR

Dev lead hoặc người phụ trách release

Duyệt

1 reviewer + CI xanh

Cách merge

Merge commit (không squash)

Sau merge

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

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

• Các PR 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. Mở Pull Request (khuyến nghị)
gh pr create --base staging --head develop \
  --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ở PR

Release manager

Duyệt

2 reviewer (gồm tech lead) + CI xanh

Cách merge

Merge commit, sau đó gắn tag phiên bản

Sau merge

Deploy production, theo dõi log và metric

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

• QA / UAT trên staging đã sign-off
• Regression test và smoke test đạt
• Release note và changelog đã cập nhật
• Có kế hoạch rollback và thời điểm deploy được thống nhất
• Biến môi trường, secret và migration production đã sẵn sàng

Lệnh

# 1. Mở Pull Request
gh pr create --base main --head staging \
  --title "Release v1.4.0"

# 2. Sau khi PR được duyệt và merge, gắn tag
git checkout main && git pull origin main
git tag -a v1.4.0 -m "Release v1.4.0"
git push origin v1.4.0

Mục tiêu

Đưa merge commit và tag 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 --tags

# 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
• PR vào main, test nhanh và merge
• Gắn tag patch (ví dụ v1.4.1) và deploy
• 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
gh pr create --base main \
  --title "Hotfix: lỗi 500 khi đăng nhập"

# sau khi merge: tag rồi đồng bộ về staging, develop
git checkout main && git pull origin main
git tag -a v1.4.1 -m "Hotfix v1.4.1"
git push origin v1.4.1