Git, GitHub, GitLab và Collaboration Workflow

🎯 Mục tiêu: Khởi tạo Git repo, đẩy lên GitHub, áp dụng Git Flow branch strategy với các nhánh main, develop và feature.

🧰 Công cụ / nền tảng: Git ≥ 2.40, GitHub CLI (gh), VS Code, Bash/WSL2 hoặc PowerShell.

📦 Chuẩn bị: Cài Git, VS Code; tạo tài khoản GitHub; cài GitHub CLI và chạy gh auth login.

▶️ Các bước (Bash / WSL2):

# 1. Tạo thư mục và khởi tạo repo cục bộ
mkdir devops-m04-lab && cd devops-m04-lab
git init
git checkout -b main

# 2. Tạo file README và commit đầu tiên
echo "# DevOps M04 Lab" > README.md
git add README.md
git commit -m "chore: initial commit"

# 3. Tạo nhánh develop (integration branch)
git checkout -b develop
echo "# Develop branch" >> README.md
git add README.md
git commit -m "chore: setup develop branch"

# 4. Tạo feature branch từ develop
git checkout -b feature/user-login develop
echo "## Feature: User Login" >> README.md
git add README.md
git commit -m "feat: scaffold user-login feature"

# 5. Tạo repo trên GitHub và push tất cả branches
gh repo create devops-m04-lab --public --source=. --remote=origin
git push -u origin main
git push -u origin develop
git push -u origin feature/user-login

# 6. Kiểm tra
git branch -a
gh repo view --web

🖥️ PowerShell (Windows — không dùng WSL2):

# Tương đương trên PowerShell — chỉ thay mkdir/echo
New-Item -ItemType Directory -Name devops-m04-lab
Set-Location devops-m04-lab
git init
git checkout -b main
"# DevOps M04 Lab" | Out-File README.md -Encoding UTF8
git add README.md
git commit -m "chore: initial commit"

✅ Kết quả mong đợi: git branch -a hiển thị 3 nhánh (main, develop, feature/user-login); GitHub repo public với 3 remote branches; git log --oneline --graph --all cho thấy cây nhánh rõ ràng.

🧹 Cleanup: Giữ repo cho LAB-017/018/019/020 hoặc gh repo delete devops-m04-lab --confirm.

🎯 Mục tiêu: Tạo conflict có chủ ý, nhận diện markers, giải quyết bằng CLI và VS Code Merge Editor, hoàn thành merge thành công.

🧰 Công cụ / nền tảng: Git, VS Code (extension GitLens tuỳ chọn), Bash/WSL2.

📦 Chuẩn bị: Repo từ LAB-016 với nhánh main và develop.

▶️ Các bước:

# 1. Trên nhánh develop, sửa dòng 1 của config.txt
git checkout develop
echo "APP_PORT=3000" > config.txt
git add config.txt && git commit -m "feat: set port 3000 on develop"

# 2. Trên nhánh feature/hotfix, sửa cùng dòng đó với giá trị khác
git checkout -b feature/hotfix-port
echo "APP_PORT=8080" > config.txt
git add config.txt && git commit -m "fix: change port to 8080"

# 3. Merge feature/hotfix-port vào develop → conflict!
git checkout develop
git merge feature/hotfix-port
# Output: CONFLICT (content): Merge conflict in config.txt

# 4. Xem trạng thái conflict
git status
cat config.txt
# Hiển thị:
# <<<<<<< HEAD
# APP_PORT=3000
# =======
# APP_PORT=8080
# >>>>>>> feature/hotfix-port

# 5a. Giải quyết bằng CLI: chọn port 8080 (phiên bản incoming)
echo "APP_PORT=8080" > config.txt
git add config.txt
git commit -m "merge: resolve port conflict — use 8080"

# 5b. Hoặc mở VS Code để dùng Merge Editor (GUI)
# code config.txt
# Nhấn "Accept Incoming Change" trong editor

# 6. Xác nhận merge thành công
git log --oneline -3
git show HEAD

🖥️ VS Code GUI:

Khi có conflict, Source Control panel hiển thị file với icon ⚠️. Click vào file → chọn "Open Merge Editor" → dùng 3-way view để chọn "Accept Current", "Accept Incoming" hoặc sửa thủ công trong Result pane → click "Accept Merge".

✅ Kết quả mong đợi: git log --oneline -3 hiển thị merge commit; cat config.txt không còn conflict markers; git diff develop feature/hotfix-port rỗng sau khi merge.

🧹 Cleanup: git branch -d feature/hotfix-port để xóa nhánh đã merge.

🎯 Mục tiêu: Tạo Pull Request từ CLI bằng gh, thêm CODEOWNERS, để lại review comment, approve và merge PR.

🧰 Công cụ / nền tảng: GitHub CLI (gh), Git, GitHub web (xem kết quả).

📦 Chuẩn bị: Repo từ LAB-016; đã push nhánh feature/user-login lên remote.

▶️ Các bước:

# 1. Tạo file CODEOWNERS (GitHub dùng để auto-assign reviewer)
mkdir -p .github
cat > .github/CODEOWNERS << 'EOF'
# Mọi file trong repo đều yêu cầu review từ @your-github-username
*   @your-github-username

# Thư mục src/ yêu cầu thêm team backend
src/   @your-github-username
EOF
git add .github/CODEOWNERS
git commit -m "chore: add CODEOWNERS"
git push origin feature/user-login

# 2. Tạo Pull Request từ CLI
gh pr create \
  --title "feat: implement user login" \
  --body "## Mô tả
Thêm flow đăng nhập user với JWT.

## Checklist
- [x] Unit tests pass
- [x] Không có hardcoded secret
- [x] Cập nhật README" \
  --base develop \
  --head feature/user-login \
  --reviewer "@your-github-username"

# 3. Xem danh sách PR
gh pr list

# 4. Xem chi tiết PR vừa tạo
gh pr view --web

# 5. Merge PR sau khi có approval (squash merge)
gh pr merge --squash --delete-branch

# 6. Xác nhận nhánh đã được xóa và develop có commit mới
git fetch origin
git log --oneline origin/develop -3

🖥️ GitHub Web:

Vào repo → tab "Pull requests" → chọn PR → "Files changed" để review từng dòng → click dòng muốn comment → "Add single comment" → "Review changes" → chọn "Approve" → "Merge pull request" → chọn "Squash and merge".

✅ Kết quả mong đợi: PR trạng thái "Merged" (màu tím); nhánh feature tự động xóa; git log --oneline origin/develop -3 chứa squash commit mới; CODEOWNERS file có mặt trong .github/.

🧹 Cleanup: git fetch --prune để xóa remote tracking branch đã bị xóa.

🎯 Mục tiêu: Cấu hình branch protection rule cho main và develop: yêu cầu PR, ít nhất 1 approval, không cho phép force-push.

🧰 Công cụ / nền tảng: GitHub CLI (gh api), GitHub web, Git.

📦 Chuẩn bị: Repo từ LAB-016 với quyền Admin.

▶️ Các bước (GitHub API qua gh):

# Lấy thông tin owner và repo
OWNER=$(gh repo view --json owner -q .owner.login)
REPO=$(gh repo view --json name -q .name)
echo "Repo: $OWNER/$REPO"

# Tạo branch protection rule cho nhánh main
gh api \
  --method PUT \
  -H "Accept: application/vnd.github+json" \
  /repos/$OWNER/$REPO/branches/main/protection \
  -f required_status_checks='{"strict":true,"contexts":[]}' \
  -f enforce_admins=false \
  -f required_pull_request_reviews='{"required_approving_review_count":1,"dismiss_stale_reviews":true}' \
  -f restrictions=null \
  -F allow_force_pushes=false \
  -F allow_deletions=false

# Kiểm tra rule đã tạo
gh api /repos/$OWNER/$REPO/branches/main/protection | \
  jq '{required_pr_reviews: .required_pull_request_reviews.required_approving_review_count,
       allow_force_push: .allow_force_pushes.enabled,
       allow_delete: .allow_deletions.enabled}'

# Thử force-push trực tiếp vào main (phải bị từ chối)
git checkout main
echo "test" >> README.md
git add README.md && git commit -m "test: direct push"
git push --force origin main
# Expected: remote: error: GH006: Protected branch update failed

🖥️ GitHub Web GUI:

Repo → Settings → Branches → "Add branch protection rule" → Branch name pattern: main → Tích "Require a pull request before merging" → "Required approvals: 1" → "Do not allow bypassing the above settings" → "Require status checks to pass" → Save changes.

✅ Kết quả mong đợi: Force-push bị từ chối với error GH006; direct push không qua PR bị block; GitHub UI hiển thị khóa 🔒 bên cạnh nhánh main trong tab Branches.

🧹 Cleanup: Xóa protection rule nếu muốn tiếp tục push trực tiếp: gh api --method DELETE /repos/$OWNER/$REPO/branches/main/protection.

🎯 Mục tiêu: Tạo annotated tag theo SemVer, push lên GitHub, tạo GitHub Release kèm release notes và changelog tự động.

🧰 Công cụ / nền tảng: Git, GitHub CLI (gh), Bash/WSL2.

📦 Chuẩn bị: Repo từ LAB-016 với ít nhất 2 commits trên main.

▶️ Các bước:

# 1. Xem lịch sử commit để quyết định version
git log --oneline -5

# 2. Tạo annotated tag v1.0.0 (initial release)
git checkout main
git tag -a v1.0.0 -m "Release v1.0.0

### What's new
- Initial project setup
- Git Flow branch strategy
- CODEOWNERS configuration

### Bug Fixes
- None (first release)
"

# 3. Push tag lên remote
git push origin v1.0.0
# Hoặc push tất cả tags: git push origin --tags

# 4. Liệt kê tags với thông tin
git tag -n10
# Output: v1.0.0   Release v1.0.0

# 5. Tạo GitHub Release từ tag vừa push
gh release create v1.0.0 \
  --title "v1.0.0 — Initial Release" \
  --notes "## Highlights
- Git Flow branch strategy implemented
- Protected branch rules configured
- CODEOWNERS for auto-assign reviews

## Breaking Changes
None — initial release." \
  --latest

# 6. Tạo pre-release tag (ví dụ v1.1.0-beta.1)
git checkout develop
# (làm thêm một số thay đổi)
echo "# beta feature" >> README.md
git add README.md && git commit -m "feat: beta feature"
git tag -a v1.1.0-beta.1 -m "Pre-release: beta testing"
git push origin v1.1.0-beta.1
gh release create v1.1.0-beta.1 --prerelease --title "v1.1.0-beta.1 — Beta" --generate-notes

# 7. Xem tất cả releases
gh release list

🖥️ GitHub Web:

Repo → Releases → "Draft a new release" → chọn tag (hoặc tạo mới) → điền title + release notes → tích "Set as latest release" → "Publish release".

✅ Kết quả mong đợi: git tag -n10 hiển thị tag với message; gh release list hiển thị v1.0.0 (Latest) và v1.1.0-beta.1 (Pre-release); GitHub Releases page có download source code (.zip, .tar.gz) tự động.

🧹 Cleanup: git tag -d v1.1.0-beta.1 && git push origin --delete v1.1.0-beta.1 để xóa pre-release tag; giữ v1.0.0 làm mẫu.