Các service của dự án: web service, worker và tác vụ theo lịch.
Thêm background worker, tác vụ theo lịch, web service khác, cơ sở dữ liệu và Valkey vào dự án — từ mã của dự án, repository khác hoặc image có sẵn — kết nối với nhau theo tên và chung một hóa đơn.
Một dự án thường không chỉ có một tiến trình. Bên cạnh ứng dụng chính, bạn có thể chạy queue worker, tác vụ ban đêm, API riêng, cơ sở dữ liệu — mỗi thứ là một service có tài nguyên riêng, tất cả trên một hóa đơn.
Các service nằm ở Tổng quan của ứng dụng → Services → Add a service. Mỗi dự án có tối đa 10 service. Service chính phải được khởi chạy trước và gói đăng ký của dự án phải còn hiệu lực (thời gian dùng thử cũng được tính).
Các loại service
| Loại | Ý nghĩa |
|---|---|
| Web service | website hoặc API khác — có địa chỉ công khai hoặc chỉ nội bộ |
| Background worker | chạy liên tục: queue, Horizon, Celery, consumer |
| Tác vụ theo lịch | khởi chạy theo lịch (định dạng cron, UTC), làm xong việc rồi dừng |
| PostgreSQL, MySQL, Valkey | cơ sở dữ liệu được quản lý — xem Cơ sở dữ liệu |
| NATS, RabbitMQ | message broker cho sự kiện và queue, chỉ nội bộ — xem Sự kiện và queue |
Địa chỉ công khai hoặc chỉ nội bộ
Khi thêm web service, bạn chọn cách truy cập — không có lựa chọn nào được chọn sẵn:
- Public address — truy cập từ internet tại
https://<name>.rivervo.app; có thể gắn tên miền riêng. - Internal only — không có địa chỉ trên internet và không có tên miền; chỉ các service khác của ứng dụng truy cập được. Phù hợp cho API phía sau website, backend quản trị hoặc công cụ tìm kiếm.
Background worker, tác vụ theo lịch và cơ sở dữ liệu không bao giờ công khai, nên không có lựa chọn này. Bạn có thể đổi sau trong Cài đặt → Public address của service — xem Giao tiếp giữa các service.
Mã lấy từ đâu
Mã của dự án này
Cùng mã nhưng khởi chạy theo cách khác: queue worker, scheduler, server WebSocket (ví dụ Laravel Reverb), một thư mục của monorepo, một API riêng.
- Command là bắt buộc — lệnh service chạy, ví dụ
php artisan queue:workhoặcnode worker.js. - Web service phải lắng nghe trên cổng trong
$PORT. - Tác vụ theo lịch còn cần Schedule ở định dạng cron (UTC), ví dụ
*/5 * * * *. - Mỗi phiên bản mới của service chính cũng được deploy cho các service này, nên chúng luôn chạy cùng một mã.
Repository khác
Web service hoặc background worker từ một repository khác trong tài khoản Git đã kết nối, với nhánh riêng và, nếu cần, Project folder và Build and start commands (để trống trường nào thì dùng giá trị chúng tôi nhận diện). Service này có các lần deploy và phiên bản riêng, và deploy mỗi lần push lên nhánh của nó. Bản xem trước theo nhánh hiện chưa có cho service.
Image có sẵn
Web service hoặc background worker từ một image có sẵn (Docker image) trên Docker Hub, GitHub Container Registry hoặc registry khác — ví dụ nginx:1.27 hoặc ghcr.io/org/app:tag.
- Port — cổng image lắng nghe; chúng tôi cũng truyền nó qua
$PORT. - Command — không bắt buộc; để trống thì image khởi chạy theo cách nó được build.
- Private registry — tên người dùng và mật khẩu hoặc access token. Thông tin được lưu mã hóa, chỉ dùng để tải image và không bao giờ hiển thị lại.
- Khi bật deploy tự động, chúng tôi kiểm tra mỗi ngày một lần xem tag có trỏ tới phiên bản mới hơn không và deploy phiên bản đó. Download the image again ở tab Deploys làm việc này ngay lập tức.
Kafka (mẫu)
Kafka trong Add a service là cấu hình dựng sẵn một cú nhấp: tạo service từ image Apache Kafka chính thức (3.9) — một broker ở chế độ KRaft, không cần ZooKeeper. Phù hợp cho phát triển và tải vừa phải.
- Internal only — không có địa chỉ công khai và không truy cập được từ bên ngoài; chỉ các service của ứng dụng kết nối được.
- Các service mã khác của ứng dụng nhận
KAFKA_BROKERS=<service name>:9092vàRIVERVO_<NAME>_URL=<service name>:9092. - Topic được tạo tự động khi dùng lần đầu.
- Khởi đầu với 1 GB bộ nhớ · 1 nhân CPU · 10 GB ổ đĩa. Như mọi service từ image có sẵn, bạn có thể đổi tài nguyên và biến.
- Dữ liệu được lưu trong thư mục dữ liệu của service trên ổ đĩa của nó.
Những gì không có:
- Chỉ một broker — không có replication; mọi topic có replication factor là 1.
- Không có sao lưu Kafka được quản lý. Bản sao lưu hằng ngày sao chép thư mục dữ liệu dưới dạng tệp trong khi Kafka đang chạy. Đó không phải bản sao lưu Kafka nhất quán: sau khi khôi phục, có thể thiếu các tin nhắn gần đây, hoặc Kafka có thể cần khôi phục log khi khởi động.
- Không có khung giờ bảo trì, không truy cập từ bên ngoài và không có Kafka UI.
- Việc nâng cấp Kafka do bạn tự thực hiện: đổi image trong Cài đặt của service.
Với queue và sự kiện có sao lưu và biến kết nối được thiết lập sẵn, xem Sự kiện và queue — NATS và RabbitMQ.
Kết nối với nhau theo tên
Các service của dự án giao tiếp qua mạng riêng theo tên: service tên api được các service khác truy cập là api, cơ sở dữ liệu tên db là db, và service chính là web. Lưu lượng giữa các service của dự án không được tính là lưu lượng.
Mỗi web service hiển thị Internal address — ví dụ http://api:8080 — và các service khác nhận địa chỉ này trong biến RIVERVO_API_URL. Cách hoạt động, service chỉ nội bộ, nhiều instance và timeout: Giao tiếp giữa các service.
Mỗi service nhận các biến của dự án — gồm cả thông tin kết nối cơ sở dữ liệu — cùng các biến riêng của nó, và biến riêng được ưu tiên hơn biến của dự án. Xem Biến môi trường.
Tài nguyên và giá
Mỗi service có Memory, CPU và Disk riêng, tính giá như mọi ứng dụng: 171.422 ₫ mỗi GB bộ nhớ và 114.281 ₫ mỗi nhân CPU mỗi tháng, kèm 10 GB ổ đĩa cho mỗi GB bộ nhớ, phần vượt tính 4.286 ₫ mỗi GB. Mỗi service có tối đa 8 GB bộ nhớ.
Khi bạn thêm service, giá của nó được cộng vào hóa đơn của dự án — với tháng hiện tại chỉ tính phần còn lại. Trong thời gian dự án dùng thử miễn phí, service mới được miễn phí đến khi hết thời gian dùng thử.
Tổng quan hiển thị Project total — tổng chi phí hằng tháng của mọi service trong dự án.
Worker ngay trong ứng dụng
Không phải lúc nào bạn cũng cần service riêng. Tab Processes của ứng dụng chính có:
- Background workers — tối đa 5 tiến trình chạy lâu dài bên cạnh website, ví dụ queue worker. Chúng dùng chung tài nguyên của ứng dụng và khởi động lại ở mỗi lần deploy.
- Scheduled commands — tối đa 10 lệnh chạy theo lịch (định dạng cron, UTC). Kết quả của chúng nằm trong log ở mục Schedule.
- Console — chạy một lệnh một lần bên trong ứng dụng đang chạy, với biến và cơ sở dữ liệu của ứng dụng. Mỗi lệnh chạy tối đa 15 phút; lệnh tương tác (tinker, shell) không được hỗ trợ ở đây.
Service riêng là lựa chọn tốt hơn khi worker cần tài nguyên riêng, để queue nặng không bao giờ làm chậm website.
Thay đổi service
Mở service từ danh sách Services. Cài đặt của service chứa lệnh, lịch, image hoặc nhánh, và tài nguyên; thay đổi được lưu và service khởi động lại với cấu hình mới. Mỗi service cũng có Logs và Monitoring riêng.