Tài Liệu Triển Khai Dự Án Search — Docker#
Triển Khai Dự Án Search Production với Docker
🔥 Tổng Quan#
Tài liệu này mô tả quy trình build và triển khai dự án Search chạy trên Docker trong môi trường production. Dự án Search bao gồm hai dịch vụ chính:| Dịch Vụ | Công Nghệ | Runtime | Mục Đích |
|---|
| API | Golang | Go binary + Supervisor | API backend cho tìm kiếm |
| Tool | Bun (TypeScript) | Bun + Supervisor + Chrome | Công cụ tự động đánh chỉ mục tìm kiếm |
🔌 Dịch Vụ API#
Tech Stack#
Xây dựng: go mod download → go build -o se-api cmd/main.go
Runtime: Go binary + Supervisor
Cấu Trúc Dự Án#
Search/api/
├─ build/
│ ├─ Dockerfile-base # Base image: Supervisor
│ ├─ Dockerfile # Production: Go build
│ ├─ api/ # ⚡ Git submodule — Go source
│ └─ conf/supervisor/search-api.conf
├─ database/
└─ docker-compose.yml.production
Xây dựng Pipeline#
┌─────────────────────────────────────────────────────────────┐
│ GO BUILD PIPELINE │
│ │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ GIAI ĐOẠN 1 │ │ GIAI ĐOẠN 2 │ │
│ │ build │───────────▶│ production │ │
│ │ │ │ │ │
│ │ • go mod │ │ • Base │ │
│ │ download │ │ image │ │
│ │ • go build │ │ • Supervisor│ │
│ │ • se-api │ │ • se-api │ │
│ │ binary │ │ binary │ │
│ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────┘
Xây dựng & Triển Khai#
Tech Stack#
Framework: Bun (TypeScript)
Xây dựng: bun install → bun compile
Runtime: Bun + Supervisor + Google Chrome Stable
Cấu Trúc Dự Án#
Search/tool-v2/
├─ build/
│ ├─ Dockerfile-base # Base image: Supervisor + Chrome
│ ├─ Dockerfile # Production image
│ ├─ tools/ # ⚡ Git submodule — Bun source
│ └─ conf/supervisor/search-tool.conf
├─ docs/
│ ├─ swap-memory/README.md
│ └─ vi-VN/README.md
├─ media/
└─ docker-compose.yml.production
Xây dựng & Triển Khai#
🛡️ Các Thực Hành Bảo Mật#
1.
.env không bao giờ nhúng vào image — mount dưới dạng read-only volume khi runtime
2.
Container non-root — tất cả chạy dưới user không đặc quyền (UID: 1200)
3.
Supervisor quản lý — auto-restart khi có lỗi
📚 Tài Liệu Liên Quan#
Ngày cập nhật 2026-03-30 05:20:28