Service dalam proyek: web service, worker, dan scheduled job.
Tambahkan background worker, scheduled job, web service lain, database, dan Valkey ke proyek — dari kodenya sendiri, repository lain, atau image siap pakai — dapat dijangkau lewat nama dan dalam satu tagihan.
Sebuah proyek terdiri dari lebih dari satu proses. Di samping aplikasi utama, Anda dapat menjalankan queue worker, job malam hari, API terpisah, database — masing-masing sebagai service dengan resource sendiri, semuanya dalam satu tagihan.
Service tercantum di Ringkasan aplikasi → Service → Tambah service. Satu proyek dapat memiliki hingga 10 service. Service utama harus diluncurkan lebih dulu, dan langganan proyek harus aktif (masa uji coba juga dihitung).
Jenis service
| Jenis | Isinya |
|---|---|
| Web service | website atau API lain — dengan alamat publik atau hanya internal |
| Background worker | berjalan terus-menerus: antrean, Horizon, Celery, consumer |
| Scheduled job | dimulai sesuai jadwal (format cron, UTC), menyelesaikan tugasnya, lalu berhenti |
| PostgreSQL, MySQL, Valkey | database terkelola — lihat Database |
| NATS, RabbitMQ | message broker untuk event dan antrean, hanya internal — lihat Event dan antrean |
Alamat publik atau hanya internal
Saat Anda menambahkan web service, pilih cara service dapat dijangkau — tidak ada yang dipilih sebelumnya:
- Alamat publik — terbuka dari internet di
https://<name>.rivervo.app; dapat memiliki domain Anda sendiri. - Hanya internal — tanpa alamat di internet dan tanpa domain; hanya service lain dalam aplikasi yang dapat menjangkaunya. Cocok untuk API di belakang website Anda, backend admin, atau mesin pencari.
Background worker, scheduled job, dan database tidak pernah publik, jadi tidak ada pilihan untuk mereka. Anda dapat mengubahnya nanti di Pengaturan → Alamat publik milik service — lihat Komunikasi antar-service.
Asal kode
Kode proyek ini
Kode yang sama dijalankan dengan cara lain: queue worker, scheduler, server WebSocket (misalnya Laravel Reverb), folder dalam monorepo, API terpisah.
- Perintah wajib diisi — apa yang dijalankan service, misalnya
php artisan queue:workataunode worker.js. - Web service harus listen di port pada
$PORT. - Scheduled job juga memerlukan Jadwal dalam format cron (UTC), misalnya
*/5 * * * *. - Setiap versi baru service utama juga di-deploy ke service ini, sehingga semuanya selalu menjalankan kode yang sama.
Repository lain
Web service atau background worker dari repository lain di akun Git yang terhubung, dengan branch sendiri dan, jika perlu, Folder proyek serta Perintah build dan start (biarkan kosong untuk menggunakan yang kami deteksi). Service ini memiliki deploy dan versi sendiri, serta men-deploy setiap push ke branch-nya. Preview branch belum dibuat untuk service.
Image siap pakai
Web service atau background worker dari image siap pakai (Docker image) di Docker Hub, GitHub Container Registry, atau registry lain — misalnya nginx:1.27 atau ghcr.io/org/app:tag.
- Port — port tempat image listen; kami juga meneruskannya di
$PORT. - Perintah — opsional; jika kosong, image dijalankan sesuai cara build-nya.
- Registry privat — nama user dan password atau access token. Disimpan terenkripsi, hanya digunakan untuk mengunduh image, dan tidak pernah ditampilkan lagi.
- Jika deploy otomatis aktif, kami memeriksa sekali sehari apakah tag mengarah ke versi yang lebih baru dan men-deploy-nya. Unduh image lagi di tab Deploy langsung melakukannya.
Kafka (template)
Kafka di Tambah service adalah preset sekali klik: membuat service dari image resmi Apache Kafka (3.9) — satu broker dalam mode KRaft, tanpa ZooKeeper. Cocok untuk development dan beban sedang.
- Hanya internal — tanpa alamat publik dan tanpa akses dari luar; hanya service aplikasi yang dapat menjangkaunya.
- Service kode lain dalam aplikasi mendapat
KAFKA_BROKERS=<service name>:9092danRIVERVO_<NAME>_URL=<service name>:9092. - Topic dibuat otomatis saat pertama kali digunakan.
- Dimulai dengan memori 1 GB · 1 core CPU · disk 10 GB. Seperti service lain dari image siap pakai, Anda dapat mengubah resource dan variabelnya.
- Datanya disimpan di folder data service pada disk-nya.
Yang tidak dimiliki:
- Satu broker — tanpa replikasi; setiap topic memiliki replication factor 1.
- Tanpa backup Kafka terkelola. Backup harian menyalin folder datanya sebagai file saat Kafka berjalan. Itu bukan backup Kafka yang konsisten: setelah pemulihan, pesan terbaru bisa hilang, atau Kafka mungkin perlu memulihkan log-nya saat dimulai.
- Tanpa jadwal pemeliharaan, tanpa akses dari luar, dan tanpa Kafka UI.
- Upgrade Kafka menjadi tanggung jawab Anda: ganti image di Pengaturan service.
Untuk antrean dan event dengan backup serta variabel koneksi yang sudah diatur untuk Anda, lihat Event dan antrean — NATS dan RabbitMQ.
Saling menjangkau lewat nama
Service dalam proyek berkomunikasi melalui jaringan privat menggunakan nama: service bernama api dapat dijangkau service lain sebagai api, database bernama db sebagai db, dan service utama sebagai web. Trafik antar-service dalam proyek tidak dihitung sebagai trafik.
Setiap web service menampilkan Alamat internal-nya — misalnya http://api:8080 — dan service lain mendapatkannya dalam variabel, RIVERVO_API_URL. Cara kerjanya, service hanya internal, beberapa instance, dan timeout: Komunikasi antar-service.
Setiap service mendapat variabel proyek — termasuk koneksi database — ditambah variabelnya sendiri, yang lebih diutamakan daripada variabel proyek. Lihat Variabel lingkungan.
Resource dan harga
Setiap service memiliki Memori, CPU, dan Disk sendiri, dengan harga seperti aplikasi lainnya: $6,66 per GB memori dan $4,44 per core CPU per bulan, dengan disk 10 GB termasuk untuk setiap GB memori, selebihnya $0,17 per GB. Satu service dapat memiliki memori hingga 8 GB.
Saat Anda menambahkan service, harganya ditambahkan ke tagihan proyek — untuk bulan berjalan hanya sisa bulannya. Selama proyek dalam masa uji coba gratis, service baru gratis hingga masa uji coba berakhir.
Ringkasan menampilkan Total proyek — biaya semua service proyek per bulan.
Worker di dalam aplikasi itu sendiri
Anda tidak selalu memerlukan service terpisah. Tab Proses aplikasi utama memiliki:
- Background worker — hingga 5 proses yang berjalan lama di samping website, misalnya queue worker. Semuanya berbagi resource aplikasi dan restart di setiap deploy.
- Perintah terjadwal — hingga 10 perintah sesuai jadwal (format cron, UTC). Output-nya ada di log pada Jadwal.
- Konsol — jalankan perintah sekali jalan di dalam aplikasi yang berjalan, dengan variabel dan database-nya. Perintah dapat berjalan hingga 15 menit; perintah interaktif (tinker, shell) tidak didukung di sini.
Service terpisah adalah pilihan yang lebih baik jika worker membutuhkan resource sendiri, agar antrean yang berat tidak pernah memperlambat website.
Mengubah service
Buka service dari daftar Service. Pengaturan-nya berisi perintah, jadwal, image atau branch, dan resource-nya; perubahan disimpan dan service restart dengan pengaturan baru. Setiap service juga memiliki Log dan Monitoring sendiri.