Tài Liệu Triển Khai sport-admin — Laravel API & Static Client trên Docker

Triển Khai Admin Panel: API (Laravel) + Client (Static Nginx) trên AWS

🔎 Tổng Quan

Dự án sport-admin gồm hai thành phần tạo nên bảng quản trị:

Thành phần	Loại	Thư mục	ECR Repository
admin-api	Laravel FPM+Web+CLI	`admin-api/`	`sports/wsport-admin-api-prod`
admin-client	Static Nginx	`admin-client/`	`sports/wsport-admin-client-prod`

Tổng Quan Kiến Trúc

┌──────────────────────────────────────────────────────────────────────────┐
│                     MÔI TRƯỜNG PRODUCTION AWS                            │
│                                                                          │
│  ┌─────────────────────────┐       ┌─────────────────────────┐           │
│  │     admin-client        │       │       admin-api         │           │
│  │                         │       │                         │           │
│  │  ┌───────────────────┐  │       │  ┌──────┐ ┌──────┐      │           │
│  │  │   Nginx (Static)  │  │       │  │ FPM  │ │ Web  │      │           │
│  │  │  • Built SPA      │──┼──API──┼─▶│      │◀┤Nginx │      │           │
│  │  │  • Port 80        │  │       │  │ :9000│ │ :80  │      │           │
│  │  └───────────────────┘  │       │  └──────┘ └──────┘      │           │
│  │                         │       │  ┌──────┐               │           │
│  └─────────────────────────┘       │  │ CLI  │               │           │
│                                    │  │Sched.│               │           │
│                                    │  └──────┘               │           │
│                                    └─────────────────────────┘           │
│                                                                          │
│  Networks: proxy-network, backend-network,                               │
│            bongda-cache-network, bongda-database-network                 │
└──────────────────────────────────────────────────────────────────────────┘

📦 Yêu Cầu Tiên Quyết

Công cụ	Phiên bản tối thiểu	Mục đích
Docker	≥ 24.0.0	Build và chạy container
Docker Compose	≥ 2.20.0	Điều phối nhiều container
AWS CLI	≥ 2.0	Xác thực và push lên AWS ECR
Git	≥ 2.30	Quản lý source code & submodules

Phần 1 — Admin API (Laravel FPM+Web+CLI)

🔎 Tổng Quan

admin-api là backend API Laravel cho bảng quản trị sport, chạy với kiến trúc Docker 3 service: PHP-FPM, Nginx Web, và CLI (scheduler/queue worker). Thành phần này kết nối tới 4 networks bao gồm cache và database networks riêng.

Chi Tiết Dự Án

Mục	Giá trị
ECR Repository	`sports/wsport-admin-api-prod`
Source Branch	`production`
Services	`fpm` + `web` + `cli`
Submodule Path	`admin-api/build/source`

Cấu Trúc Thư Mục

admin-api/
├── build/
│   ├── Dockerfile-base.production          # Base image cho FPM/CLI
│   ├── Dockerfile.production               # Build multi-stage (FPM + Web + CLI)
│   ├── data/php/                           # Cấu hình PHP (php.ini, php-fpm.conf)
│   └── source/                             # Git submodule → source code
├── .env.production                         # Biến môi trường production
└── docker-compose.yml.production           # Docker Compose cho production

⚙ Cấu Hình

Bước 1: Khởi Tạo Submodule

Bước 2: Tạo Docker Volumes

Bước 3: Cấu Hình Biến Môi Trường

Bước 4: Cấu Hình Source .env

🏭 Build & Đẩy Image Lên AWS ECR

Đăng Nhập AWS ECR

Build & Push Tất Cả Service Images

Tham Khảo Runtime — Admin API

Service	Image Tag	Port	Mục đích
`fpm`	`:fpm-latest`	9000	PHP-FPM xử lý request Laravel
`web`	`:web-latest`	80	Nginx phục vụ static files & proxy→FPM
`cli`	`:cli-latest`	—	Laravel scheduler & queue worker

Volume	Đường dẫn Container	Chế độ	Services
`wsport_admin_api_storage-data`	`/opt/apps/laravel/storage`	RW	fpm, web, cli
`wsport_admin_api_bootstrap-data`	`/opt/apps/laravel/bootstrap`	RW	fpm, web, cli
`build/source/.env`	`/opt/apps/laravel/.env`	RO	fpm, cli

Network	Mục đích
`proxy-network`	Giao tiếp reverse proxy
`backend-network`	Giao tiếp services backend
`bongda-cache-network`	Kết nối Redis / ElastiCache
`bongda-database-network`	Kết nối RDS / database

Phần 2 — Admin Client (Static Nginx)

🔎 Tổng Quan

admin-client là frontend static đã build sẵn cho bảng quản trị sport, phục vụ bởi một container Nginx đơn. Source code được build trong quá trình build Docker image (Node.js → static files).

Chi Tiết Dự Án

Mục	Giá trị
ECR Repository	`sports/wsport-admin-client-prod`
Source Branch	`production`
Services	`web` (chỉ Nginx)
Submodule Path	`admin-client/build/source`
Volumes	Không có

Cấu Trúc Thư Mục

admin-client/
├── build/
│   ├── Dockerfile.production               # Multi-stage: Node.js build → Nginx
│   └── source/                             # Git submodule → source code
├── .env.production                         # Biến môi trường production
└── docker-compose.yml.production           # Docker Compose cho production

Pipeline Build

┌──────────────────────────────────────────────────────────────────────────┐
│              PIPELINE BUILD — ADMIN CLIENT (STATIC)                      │
│                                                                          │
│  ┌────────────────────┐                                                  │
│  │     builder        │                                                  │
│  │                    │                                                  │
│  │  • Node.js         │                                                  │
│  │  • npm install     │                                                  │
│  │  • npm run build   │                                                  │
│  │    → /dist         │                                                  │
│  └────────┬───────────┘                                                  │
│           │                                                              │
│           ▼                                                              │
│  ┌────────────────────┐                                                  │
│  │   production       │                                                  │
│  │  (nginx:alpine)    │                                                  │
│  │                    │                                                  │
│  │  • Nginx config    │                                                  │
│  │  • Static files    │                                                  │
│  │  • Port 80         │                                                  │
│  └────────┬───────────┘                                                  │
│           ▼                                                              │
│  ┌────────────────────┐                                                  │
│  │    ECR Push        │                                                  │
│  │    :latest         │                                                  │
│  └────────────────────┘                                                  │
└──────────────────────────────────────────────────────────────────────────┘

⚙ Cấu Hình

Khởi Tạo Submodule

Cấu Hình Biến Môi Trường

🏭 Build & Đẩy Image Lên AWS ECR

Tham Khảo Runtime — Admin Client

Network	Mục đích
`proxy-network`	Giao tiếp reverse proxy

Tài liệu triển khai dự án Sport Admin

Tài Liệu Triển Khai sport-admin — Laravel API & Static Client trên Docker

🔎 Tổng Quan

Tổng Quan Kiến Trúc

📦 Yêu Cầu Tiên Quyết

Phần 1 — Admin API (Laravel FPM+Web+CLI)

🔎 Tổng Quan

Chi Tiết Dự Án

Cấu Trúc Thư Mục

⚙ Cấu Hình

Bước 1: Khởi Tạo Submodule

Bước 2: Tạo Docker Volumes

Bước 3: Cấu Hình Biến Môi Trường

Bước 4: Cấu Hình Source .env

🏭 Build & Đẩy Image Lên AWS ECR

Đăng Nhập AWS ECR

Build & Push Tất Cả Service Images

Tham Khảo Runtime — Admin API

Phần 2 — Admin Client (Static Nginx)

🔎 Tổng Quan

Chi Tiết Dự Án

Cấu Trúc Thư Mục

Pipeline Build

⚙ Cấu Hình

Khởi Tạo Submodule

Cấu Hình Biến Môi Trường

🏭 Build & Đẩy Image Lên AWS ECR

Tham Khảo Runtime — Admin Client

🚀 Triển Khai Lên Production

Triển Khai Admin API

Thiết Lập Laravel Sau Triển Khai

Triển Khai Admin Client

Kiểm Tra Trạng Thái

Tài liệu triển khai dự án Sport Admin

Tài Liệu Triển Khai sport-admin — Laravel API & Static Client trên Docker#

🔎 Tổng Quan#

Tổng Quan Kiến Trúc#

📦 Yêu Cầu Tiên Quyết#

Phần 1 — Admin API (Laravel FPM+Web+CLI)#

🔎 Tổng Quan#

Chi Tiết Dự Án#

Cấu Trúc Thư Mục#

⚙ Cấu Hình#

Bước 1: Khởi Tạo Submodule#

Bước 2: Tạo Docker Volumes#

Bước 3: Cấu Hình Biến Môi Trường#

Bước 4: Cấu Hình Source .env#

🏭 Build & Đẩy Image Lên AWS ECR#

Đăng Nhập AWS ECR#

Build & Push Tất Cả Service Images#

Tham Khảo Runtime — Admin API#

Phần 2 — Admin Client (Static Nginx)#

🔎 Tổng Quan#

Chi Tiết Dự Án#

Cấu Trúc Thư Mục#

Pipeline Build#

⚙ Cấu Hình#

Khởi Tạo Submodule#

Cấu Hình Biến Môi Trường#

🏭 Build & Đẩy Image Lên AWS ECR#

Tham Khảo Runtime — Admin Client#

🚀 Triển Khai Lên Production#

Triển Khai Admin API#

Thiết Lập Laravel Sau Triển Khai#

Triển Khai Admin Client#

Kiểm Tra Trạng Thái#

Tài Liệu Triển Khai sport-admin — Laravel API & Static Client trên Docker

🔎 Tổng Quan

Tổng Quan Kiến Trúc

📦 Yêu Cầu Tiên Quyết

Phần 1 — Admin API (Laravel FPM+Web+CLI)

🔎 Tổng Quan

Chi Tiết Dự Án

Cấu Trúc Thư Mục

⚙ Cấu Hình

Bước 1: Khởi Tạo Submodule

Bước 2: Tạo Docker Volumes

Bước 3: Cấu Hình Biến Môi Trường

Bước 4: Cấu Hình Source .env

🏭 Build & Đẩy Image Lên AWS ECR

Đăng Nhập AWS ECR

Build & Push Tất Cả Service Images

Tham Khảo Runtime — Admin API

Phần 2 — Admin Client (Static Nginx)

🔎 Tổng Quan

Chi Tiết Dự Án

Cấu Trúc Thư Mục

Pipeline Build

⚙ Cấu Hình

Khởi Tạo Submodule

Cấu Hình Biến Môi Trường

🏭 Build & Đẩy Image Lên AWS ECR

Tham Khảo Runtime — Admin Client

🚀 Triển Khai Lên Production

Triển Khai Admin API

Thiết Lập Laravel Sau Triển Khai

Triển Khai Admin Client

Kiểm Tra Trạng Thái