Staging

Triển Khai Social Tool ở môi trường staging với Docker

Website · Cấu Hình · Xây Dựng & Triển Khai

🔥 Tổng Quan

Tài liệu này mô tả quy trình xây dựng và triển khai dịch vụ Social Tool chạy trên Docker trong môi trường staging.

Tech Stack

Framework: Bun (TypeScript) + Puppeteer

Xây dựng: bun install → bun run build → bun compile

Runtime: Bun + Supervisor + Google Chrome Stable

Local: social/tool-stg

Cơ sở dữ liệu: MongoDB

Source: Git submodule tại build/tools/

📖 Tài Liệu Tham Khảo

Xem thêm tài liệu tại docs.docker.com và FAQ tại đây.

🚧 Cấu Trúc Dự Án

Social/tool/
├─ build/
│  ├─ Dockerfile.staging                    # Staging build
│  ├─ tools/                                    # ⚡ Git submodule — Bun source
│  │  ├─ .env
│  │  ├─ package.json
│  │  ├─ bun.lock
│  │  └─ src/
│  └─ conf/
│     └─ supervisor/social-tool.conf            # Cấu hình Supervisor
├─ .env.staging                             # Biến môi trường Docker Compose
└─ docker-compose.yml.staging                # Compose file

📦 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	Quản lý container
Google Chrome Stable	≥ 130.0.0	Chrome headless cho tự động hóa
MongoDB	≥ 7	Máy chủ cơ sở dữ liệu

Lưu ý: Nếu máy chủ không có phân vùng swap mặc định, có thể khởi tạo swap memory để đảm bảo hiệu năng social-tool khi vận hành ở tần suất cao từ 22 đến 25 tiến trình đồng thời.

🏗️ Pipeline Xây dựng

┌──────────────────────────────────────────────────────────────┐
│                 BUN + CHROME BUILD PIPELINE                   │
│                                                               │
│  ┌─────────────┐            ┌──────────────┐                  │
│  │ GIAI ĐOẠN 1 │            │ GIAI ĐOẠN 2  │                  │
│  │    build    │───────────▶│  staging     │                  │
│  │             │            │              │                  │
│  │ • bun       │            │              │
│  │   install   │            │ • Supervisor │                  │
│  │ • bun run   │            │ • Google     │                  │
│  │   build     │            │   Chrome     │                  │
│  │ • bun       │            │ • Bun dist   │                  │
│  │   compile   │            │              │                  │
│  └─────────────┘            └──────────────┘                  │
└──────────────────────────────────────────────────────────────┘

❄️ Cấu Hình

Biến Môi Trường Docker Compose (`.env.staging`)

Biến Môi Trường Ứng Dụng (`build/tools/.env`)

Thiết Lập Cơ Sở Dữ Liệu (MongoDB)

🚀 Xây dựng & Triển Khai

🛡️ Các Thực Hành Bảo Mật

.env không bao giờ nhúng vào image — mount dưới dạng read-only volume khi runtime

Container non-root — chạy dưới user không đặc quyền (UID: 1200)

Supervisor quản lý — auto-restart khi có lỗi

Puppeteer chromium bỏ qua — dùng Chrome hệ thống thay vì Chromium đóng gói

📚 Tài Liệu Liên Quan

Hướng dẫn Swap Memory

Tài Liệu Xây Dựng & Triển Khai Social Tool — Docker#

🔥 Tổng Quan#

Tech Stack#

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

🚧 Cấu Trúc Dự Án#

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

🏗️ Pipeline Xây dựng#

❄️ Cấu Hình#

Biến Môi Trường Docker Compose (.env.staging)#

Biến Môi Trường Ứng Dụng (build/tools/.env)#

Thiết Lập Cơ Sở Dữ Liệu (MongoDB)#

🚀 Xây dựng & Triển Khai#

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

📚 Tài Liệu Liên Quan#

Tài Liệu Xây Dựng & Triển Khai Social Tool — Docker