Developer push code
        │
        ▼
  GitLab nhận push
        │
        ▼
 Pipeline kích hoạt
 (theo nhánh push)
        │
        ├── develop-v2  →  [deploy-develop]   → Máy chủ Dev
        ├── staging-v2  →  [deploy-staging]   → Máy chủ Staging
        ├── release-v2  →  [deploy-release]   → Máy chủ Release
        └── master-v2   →  [build-master]     → Build Docker image → AWS ECR
                              └── [deploy-master] → Máy chủ Production

Push lên nhánh → Pipeline kích hoạt job tương ứng
develop-v2     → deploy-develop
staging-v2     → deploy-staging
release-v2     → deploy-release

Step 1: GitLab Runner khởi động job
        │
        ▼
Step 2: Nạp SSH Key vào Agent
        (Key được lưu dưới dạng Base64 trong GitLab CI Variables)
        - Giải mã Base64 từ biến $TRAFFIC_DEV_KEY
        - Đăng ký vào ssh-agent
        - Cấu hình SSH bỏ qua kiểm tra host
        │
        ▼
Step 3: SSH vào máy chủ Worker Target
        (dùng IP và Port từ CI Variables)
        │
        ▼
Step 4: [Trên máy chủ Worker] Kéo code mới nhất
        - Kiểm tra thư mục dự án đã tồn tại chưa
        - git pull origin — cập nhật repo wrapper
        - cd build/tools && git checkout {branch} && git pull — cập nhật submodule mã nguồn chính
        │
        ▼
Step 5: [Trên máy chủ Worker] Build và khởi động Docker
        - docker compose up --build -d
        - Docker đọc Dockerfile trong thư mục build/
        - Build image từ mã nguồn mới nhất
        - Khởi động container với cấu hình trong docker-compose.yml
        │
        ▼
Step 6: Dọn dẹp image thừa
        - docker image prune -f
        - Xóa các image cũ không còn được sử dụng
        │
        ▼
Pipeline kết thúc ✅

Push lên master-v2
        │
        ▼
Step 1: SSH vào máy Build Server (Bastion)
        │
        ▼
Step 2: Đăng nhập AWS ECR
        aws ecr get-login-password | docker login --username AWS --password-stdin {ECR}
        │
        ▼
Step 3: Cập nhật mã nguồn
        - git pull origin (cập nhật repo chính)
        - git checkout master-v2 && git pull (cập nhật submodule)
        │
        ▼
Step 4: Kéo image cũ về để dùng làm build cache
        docker pull {ECR}/{IMAGE}:latest || true
        (|| true: không dừng pipeline nếu chưa có image nào)
        │
        ▼
Step 5: Build Docker image
        docker buildx build \
          --cache-from {TAG_LATEST} \   ← Dùng cache từ image cũ để tăng tốc
          --platform linux/amd64 \       ← Chỉ định kiến trúc CPU
          -t {TAG_LATEST} \             ← Gán tag :latest
          -t {TAG_COMMIT} \             ← Gán tag theo commit hash
          --push .                       ← Push thẳng lên AWS ECR
        │
        ▼
Step 6: Dọn dẹp image local
        docker image prune -f
        │
        ▼
Image mới đã có trên AWS ECR ✅

Sau khi build-master thành công
        │
        ▼
Step 1: SSH vào từng máy chủ Production Worker
        (Lặp qua danh sách IP trong $VNETWORK_TRAFFIC_PROD_IP)
        │
        ▼
Step 2: Đăng nhập AWS ECR trên máy Production
        aws ecr get-login-password | docker login --username AWS --password-stdin {ECR}
        │
        ▼
Step 3: Kéo image mới nhất về máy Production
        docker pull {ECR}/{IMAGE}:latest
        │
        ▼
Step 4: Cập nhật file cấu hình
        git pull origin (cập nhật docker-compose.yml và .env nếu có thay đổi)
        │
        ▼
Step 5: Khởi động lại container với image mới
        docker compose up -d --force-recreate --remove-orphans
        - --force-recreate: buộc tạo lại container dù config không đổi
        - --remove-orphans: xóa container cũ không còn trong compose file
        │
        ▼
Step 6: Dọn dẹp image cũ
        docker image prune -f
        │
        ▼
Production cập nhật thành công ✅

feature/xxx  →  develop-v2  →  staging-v2  →  release-v2  →  master-v2
   (phát         (kiểm thử      (test tích     (kiểm thử     (production
   triển)         hàng ngày)     hợp)           cuối cùng)    thật)