1. Deployment
One Push
  • Tổng Quan
  • Bussiness Logic
    • ĐẶC TẢ KỸ THUẬT: HỆ THỐNG ĐIỀU PHỐI TIN NHẮN (PUSH ENGINE)
    • ĐẶC TẢ KỸ THUẬT: HỆ THỐNG ĐỒNG BỘ HEARTBEAT (REAL-TIME SYNC)
    • ĐẶC TẢ KỸ THUẬT: HỆ THỐNG ĐIỀU PHỐI TIN NHẮN (PUSH ENGINE)
    • Business Logic (Luồng Logic Nghiệp Vụ)
  • Project
    • API
      • Hướng dẫn sử dụng
        • 1.1 Khởi tạo Website Tham gia
        • 1.2 Cấu hình Bots Telegram
        • 1.3 Quản lý Chiến dịch (Campaigns)
        • 1.4 Lên Lịch Gửi Tự Động
        • 1.5 Tương tác & Thống kê
        • 1.6 Quản lý Tài khoản (RBAC)
        • 1.7 Báo cáo Chi tiết Tin nhắn (Web & Telegram)
      • Architecture
        • System Architecture (Kiến trúc Hệ thống)
        • Code Structure
        • Database Schema (Mô hình Dữ liệu)
      • Deployment
        • Local
        • Production
        • Development
      • API
        • Widget nhúng Website
          • Đăng ký Subscriber mới / Nhật ký Heartbeat
          • Cập nhật trạng thái Seen/Read
          • Ghi nhận hiển thị Alert Popup
          • Lấy dữ liệu Alert cho website
        • Tracking & Tương tác
          • Ghi nhận lựa chọn Yes/No
        • Báo cáo & Thống kê
          • Thống kê người dùng Real-time
          • Phân tích tăng trưởng Subscriber
          • Dữ liệu bản đồ nhiệt Vị trí
          • Xuất báo cáo thông báo Excel
        • Lịch gửi Thông báo
          • Danh sách lịch gửi thông báo
          • Tạo lịch gửi mới
          • Bật/Tắt lịch gửi
        • Betting Tips
          • Lấy Tip bóng đá HOT nhất
          • Lấy dữ liệu Mock Tip (Test)
        • Telegram Integration
          • Danh sách Telegram Bot
          • Telegram Webhook Endpoint
        • Email Marketing
          • Tạo và gửi chiến dịch Email
        • Hệ thống & RBAC
          • Danh sách tài khoản Admin/Nhân viên
          • Danh sách vai trò (Roles)
        • Tiện ích & Files
          • Truy xuất nhật ký hệ thống (System Logs)
        • Chiến dịch (Campaigns)
          • Danh sách chiến dịch
        • Website Khách hàng (Clients)
          • Danh sách website khách hàng
        • Quản lý Thành viên (Subscribers)
          • Danh sách người đăng ký (Subscribers)
          • Xóa người nhận tin
    • TOOL
      • Hướng dẫn sử dụng
        • Hướng dẫn sử dụng — Novu Notification Infrastructure
      • Architecture
        • System Architecture
        • Code Structure
        • Database Schema
      • Deployment
        • Deployment
      • API
        • 👥 Subscribers
          • Tạo/Cập nhật Subscriber
          • Cập nhật Profile
        • 🗺️ Workflows
          • Lấy danh sách Workflow Templates
          • Chi tiết Workflow
        • 📂 Notification History
          • Lịch sử biến động Notification
        • 🎯 Topics
          • Tạo Topic mới
        • 📐 Layouts
          • Lấy danh sách Layout (Email/Web)
        • 💬 Messages
          • Tra cứu vết tin nhắn chi tiết (Low-level)
        • 🔌 Integrations
          • Danh sách nhà cung cấp (Providers)
        • 🚀 Events & Triggers
          • Kích hoạt thông báo (Workflows)
          • Kích hoạt hàng loạt (Bulk Trigger)
  • Schemas
    • GenericResponse
  1. Deployment

Production

Tài Liệu Triển Khai Dự Án One Push — Production (Docker)#

Docker  Laravel  Redis  Nginx

Triển Khai Dự Án One Push — Backend Admin & Delivery Engine

🔥 Tổng Quan Production#

Tài liệu này mô tả quy trình xây dựng và triển khai dự án One Push Admin trong môi trường production, sử dụng hệ thống Containerization để đảm bảo tính ổn định và khả năng mở rộng.
Dịch VụCông NghệRuntimeMục Đích
App ServerLaravel 10 (PHP 8.2)Nginx + PHP-FPMXử lý Web UI & API Public
Worker EngineLaravel HorizonPHP + RedisGửi hàng triệu tin nhắn nền (Push)
SchedulerCronjobPHP ArtisanTự động hoá báo cáo & Sync Heartbeat

🏢 Kiến Trúc Dịch Vụ#

Tech Stack#

Framework: Laravel 10.x với PHP 8.2+
Database: MariaDB 10.11 / MySQL 8.0
Caching: Redis v7.x (Bắt buộc cho Queue & Heartbeat)
Runtime: Nginx Alpine + PHP-FPM Alpine

Cấu Trúc Docker#

OnePush/
├─ .docker/
│  ├─ Dockerfile.production                     # Multi-stage build (Composer -> FPM)
│  ├─ nginx/
│  │  └─ default.conf
│  └─ supervisor/
│     └─ worker.conf                            # Cấu hình Horizon & Scheduler
├─ .env.production
├─ artisan
└─ docker-compose.yml.production

📦 Xây dựng & Đẩy Image (CI/CD Pipeline)#

Chúng tôi sử dụng Multi-stage Build để giảm thiểu kích thước image và tăng cường bảo mật.

🚀 Quy trình Triển Khai (Deployment)#

Việc cập nhật code mới diễn ra tự động thông qua Docker Compose mà không làm gián đoạn hệ thống.

🛡️ Các Thực Hành Bảo Mật (Production Hardening)#

1.
Optimize Autoload: Chạy composer install --optimize-autoloader --no-dev trong lúc build.
2.
Read-only Filesystem: Container chạy PHP không được phép ghi vào các thư mục ngoài storage/ và bootstrap/cache.
3.
Horizon Security: Dashboard Horizon được bảo vệ bởi IP Whitelisting hoặc Basic Auth.
4.
Queue Worker: Giới hạn memory-limit=128M để tránh rò rỉ bộ nhớ khi xử lý Job lớn.

📚 Tài Liệu Tham Khảo#

Laravel Deployment
Redis Backend for Queues
Dockerizing Laravel
AWS ECR User Guide
Modified at 2026-03-27 03:49:16
Previous
Local
Next
Development
Built with