Tài Liệu Triển Khai newslooks — Laravel trên Docker

Triển Khai CMS & News Service trên Docker với AWS

🔎 Tổng Quan

Dự án newslooks là hệ thống CMS và tin tức dựa trên Laravel, chạy với kiến trúc Docker 3 service: PHP-FPM, Nginx Web, và CLI. Dự án sử dụng volume AWS EFS qua NFS để lưu trữ hình ảnh WordPress uploads.

Đặc Biệt: AWS EFS Volume

Dự án mount NFS volume từ AWS EFS cho hình ảnh WordPress uploaded:

Volume EFS map tới thư mục uploads WordPress trong container:

newslooks_news_storage-data → /opt/apps/laravel/public/prediction/wp-content/uploads:ro

🏗 Tổng Quan Kiến Trúc

Cấu Trúc Thư Mục

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

📦 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

⚙ Cấu Hình

Bước 1: Clone Repository và 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

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

Bước 1: Đăng Nhập AWS ECR

Bước 2: Build & Push Tất Cả Service Images

🚀 Triển Khai Lên Production

Bước 1: Triển Khai

Bước 2: Thiết Lập Laravel Sau Triển Khai

Bước 3: Kiểm Tra Trạng Thái

📋 Tham Khảo Cấu Hình Runtime

Volume Mounts

Volume	Đường dẫn Container	Chế độ	Loại	Services
`storage-data`	`/opt/apps/laravel/storage`	RW	local	fpm, web, cli
`bootstrap-data`	`/opt/apps/laravel/bootstrap`	RW	local	fpm, web, cli
`uploaded-data`	`/opt/apps/laravel/public/uploaded`	RW	local	fpm, web, cli
`theme-data`	`/opt/apps/laravel/resources/views/theme`	RW	local	fpm, web, cli
`news_storage-data`	`/opt/apps/laravel/public/prediction/wp-content/uploads`	RO	NFS/EFS	fpm, web
`build/source/.env`	`/opt/apps/laravel/.env`	RO	bind	fpm, cli

Networks

Network	Mục đích
`prod-network`	Giao tiếp services production
`backend-network`	Giao tiếp services backend

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

Tài Liệu Triển Khai newslooks — Laravel trên Docker#

🔎 Tổng Quan#

Đặc Biệt: AWS EFS Volume#

🏗 Tổng Quan Kiến Trúc#

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

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

⚙ Cấu Hình#

Bước 1: Clone Repository và 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#

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

Bước 1: Đăng Nhập AWS ECR#

Bước 2: Build & Push Tất Cả Service Images#

🚀 Triển Khai Lên Production#

Bước 1: Triển Khai#

Bước 2: Thiết Lập Laravel Sau Triển Khai#

Bước 3: Kiểm Tra Trạng Thái#

📋 Tham Khảo Cấu Hình Runtime#

Volume Mounts#

Networks#