Novu Scaling & Infrastructure Hub

Hệ thống Novu được thiết kế để vận hành linh hoạt (SaaS và Self-hosted), cho phép doanh nghiệp tự chủ hoàn toàn hạ tầng thông báo (Notification Infrastructure) với khả năng mở rộng không giới hạn thông qua Kubernetes.

I. Sơ đồ Kiến trúc Triển khai Cụm (Cluster Deployment)

Dưới đây là mô hình triển khai Novu trên một cụm (Cluster) thực tế với khả năng chịu tải và dự phòng cao:

II. Triển khai Nhanh với Docker Compose (Self-hosted)

Phù hợp cho môi trường thử nghiệm hoặc quy mô doanh nghiệp vừa và nhỏ.

Thư mục gốc: docker/
Lệnh khởi động:

Các Dịch vụ Cốt lõi (Core Stack)

api: Backend xử lý yêu cầu Dashboard và Trigger (Port: 3000).

worker: Bộ máy thực thi gửi tin chính.

ws: Dịch vụ Websocket thời gian thực (Port: 3002).

dashboard: Giao diện người dùng nền React (Port: 4200).

inbound-mail: Tiếp nhận và bóc tách email phản hồi.

III. Triển khai Quy mô Lớn với Kubernetes (Helm)

Novu cung cấp các bộ Helm Charts chính thức giúp tự động hóa việc vận hành trên Cloud (EKS, GKE, AKS).

1. Cài đặt Repos

2. Cấu hình Scalability

Trong file values.yaml, bạn có thể thiết lập HPA (Horizontal Pod Autoscaler) để tự động mở rộng cụm Worker khi hàng đợi Redis (BullMQ) bị quá tải:

IV. Danh mục Tham số Môi trường (.env Matrix)

Đây là "linh hồn" của quá trình cấu hình, đảm bảo tính kết nối xuyên suốt:

Biến Môi Trường	Ý Nghĩa Kỹ Thuật	Yêu Cầu
`MONGODB_URL`	Chuỗi kết nối đến cụm MongoDB	Bắt buộc
`REDIS_URL`	Địa chỉ Redis quản lý BullMQ	Bắt buộc
`JWT_SECRET`	Khóa bảo mật mã hóa Token	Bắt buộc
`STORE_ENCRYPTION_KEY`	Khóa mã hóa Credentials của Provider	Bắt buộc
`S3_STATIC_ASSETS_BUCKET`	Tên thùng chứa S3 lưu trữ Logo/Icons	Tùy chọn

V. Giám sát & Vận hành (Monitoring & Ops)

Để đảm bảo hệ thống luôn hoạt động 24/7, Novu tích hợp sẵn khả năng giám sát:

Trạng thái Hàng đợi: Theo dõi qua giao diện BullBoard (hoặc tích hợp Prometheus/Grafana) để kiểm tra số lượng Job bị Fail.

Logs: Toàn bộ chu trình gửi tin (Request -> Process -> Deliver) được ghi vết chi tiết.

Health Checks: Các Endpoint /health-check giúp Ingress Controller loại bỏ các POD lỗi ra khỏi vòng lặp phục vụ.

Deployment

Novu Scaling & Infrastructure Hub#

I. Sơ đồ Kiến trúc Triển khai Cụm (Cluster Deployment)#

II. Triển khai Nhanh với Docker Compose (Self-hosted)#

Các Dịch vụ Cốt lõi (Core Stack)#

III. Triển khai Quy mô Lớn với Kubernetes (Helm)#

1. Cài đặt Repos#

2. Cấu hình Scalability#

IV. Danh mục Tham số Môi trường (.env Matrix)#

V. Giám sát & Vận hành (Monitoring & Ops)#