Perkhidmatan projek: perkhidmatan web, pekerja dan tugas berjadual.
Tambahkan pekerja latar belakang, tugas berjadual, lebih banyak perkhidmatan web, pangkalan data dan Valkey pada projek — daripada kodnya sendiri, repositori lain atau imej sedia — boleh dihubungi melalui nama dan dalam satu bil.
Sesebuah projek lebih daripada satu proses. Di samping aplikasi utama, anda boleh menjalankan pekerja baris gilir, tugas waktu malam, API berasingan, pangkalan data — setiap satu sebagai perkhidmatan dengan sumbernya sendiri, semuanya dalam satu bil.
Perkhidmatan disenaraikan di Gambaran keseluruhan aplikasi → Perkhidmatan → Tambah perkhidmatan. Sesebuah projek boleh mempunyai sehingga 10 perkhidmatan. Perkhidmatan utama mesti dilancarkan dahulu, dan langganan projek mesti aktif (tempoh percubaan dikira).
Jenis perkhidmatan
| Jenis | Apa itu |
|---|---|
| Perkhidmatan web | laman web atau API lain — dengan alamat awam atau dalaman sahaja |
| Pekerja latar belakang | berjalan sepanjang masa: baris gilir, Horizon, Celery, consumer |
| Tugas berjadual | bermula mengikut jadual (format cron, UTC), menjalankan kerjanya dan berhenti |
| PostgreSQL, MySQL, Valkey | pangkalan data terurus — lihat Pangkalan data |
| NATS, RabbitMQ | broker mesej untuk peristiwa dan baris gilir, dalaman sahaja — lihat Peristiwa dan baris gilir |
Alamat awam atau dalaman sahaja
Apabila anda menambah perkhidmatan web, pilih cara ia boleh dihubungi — tiada apa-apa yang dipilih terlebih dahulu:
- Alamat awam — boleh dibuka dari internet di
https://<name>.rivervo.app; ia boleh mempunyai domain anda sendiri. - Dalaman sahaja — tiada alamat di internet dan tiada domain; hanya perkhidmatan lain dalam aplikasi boleh menghubunginya. Sesuai untuk API di belakang laman web anda, backend pentadbir atau enjin carian.
Pekerja latar belakang, tugas berjadual dan pangkalan data tidak pernah awam, jadi tiada pilihan untuknya. Anda boleh menukarnya kemudian dalam Tetapan → Alamat awam perkhidmatan — lihat Komunikasi antara perkhidmatan.
Dari mana kod datang
Kod projek ini
Kod yang sama dimulakan dengan cara lain: pekerja baris gilir, penjadual, pelayan WebSocket (contohnya Laravel Reverb), folder dalam monorepo, API berasingan.
- Arahan wajib — apa yang dijalankan oleh perkhidmatan, contohnya
php artisan queue:workataunode worker.js. - Perkhidmatan web mesti mendengar pada port dalam
$PORT. - Tugas berjadual juga memerlukan Jadual dalam format cron (UTC), contohnya
*/5 * * * *. - Setiap versi baharu perkhidmatan utama juga di-deploy ke perkhidmatan ini, jadi ia sentiasa menjalankan kod yang sama.
Repositori lain
Perkhidmatan web atau pekerja latar belakang daripada repositori lain dalam akaun Git anda yang disambungkan, dengan cawangannya sendiri dan, jika perlu, Folder projek serta Arahan binaan dan mula (biarkan medan kosong untuk menggunakan apa yang kami kesan). Ia mendapat deploy dan versinya sendiri serta men-deploy setiap push ke cawangannya. Pratonton cawangan belum dibuat untuk perkhidmatan.
Imej sedia
Perkhidmatan web atau pekerja latar belakang daripada imej sedia (imej Docker) di Docker Hub, GitHub Container Registry atau mana-mana registry lain — contohnya nginx:1.27 atau ghcr.io/org/app:tag.
- Port — port yang didengari oleh imej; kami juga menghantarnya dalam
$PORT. - Arahan — pilihan; jika kosong, imej dimulakan seperti yang dibina.
- Registry peribadi — nama pengguna dan kata laluan atau token akses. Ia disimpan secara tersulit, digunakan hanya untuk memuat turun imej dan tidak akan ditunjukkan lagi.
- Dengan deploy automatik dihidupkan, kami menyemak sekali sehari sama ada tag menunjuk kepada versi yang lebih baharu dan men-deploy-nya. Muat turun imej semula pada tab Deploy melakukannya serta-merta.
Kafka (templat)
Kafka dalam Tambah perkhidmatan ialah pratetap satu klik: ia mencipta perkhidmatan daripada imej rasmi Apache Kafka (3.9) — satu broker dalam mod KRaft, tanpa ZooKeeper. Ia sesuai untuk pembangunan dan beban sederhana.
- Dalaman sahaja — tiada alamat awam dan tiada akses dari luar; hanya perkhidmatan aplikasi boleh menghubunginya.
- Perkhidmatan kod lain dalam aplikasi mendapat
KAFKA_BROKERS=<service name>:9092danRIVERVO_<NAME>_URL=<service name>:9092. - Topik dicipta secara automatik kali pertama ia digunakan.
- Ia bermula dengan memori 1 GB · 1 teras CPU · cakera 10 GB. Seperti mana-mana perkhidmatan daripada imej sedia, anda boleh menukar sumber dan pemboleh ubahnya.
- Datanya disimpan dalam folder data perkhidmatan pada cakeranya.
Apa yang tiada:
- Satu broker — tiada replikasi; setiap topik mempunyai faktor replikasi 1.
- Tiada sandaran Kafka terurus. Sandaran harian menyalin folder datanya sebagai fail semasa Kafka berjalan. Itu bukan sandaran Kafka yang konsisten: selepas pemulihan, mesej terkini mungkin hilang, atau Kafka mungkin perlu memulihkan lognya semasa bermula.
- Tiada waktu penyelenggaraan, tiada akses dari luar dan tiada Kafka UI.
- Naik taraf Kafka adalah tanggungjawab anda: tukar imej dalam Tetapan perkhidmatan.
Untuk baris gilir dan peristiwa dengan sandaran dan pemboleh ubah sambungan yang disediakan untuk anda, lihat Peristiwa dan baris gilir — NATS dan RabbitMQ.
Menghubungi satu sama lain melalui nama
Perkhidmatan projek berkomunikasi melalui rangkaian peribadi menggunakan nama: perkhidmatan bernama api boleh dihubungi oleh yang lain sebagai api, pangkalan data bernama db sebagai db, dan perkhidmatan utama sebagai web. Trafik antara perkhidmatan projek tidak dikira sebagai trafik.
Setiap perkhidmatan web menunjukkan Alamat dalamannya — contohnya http://api:8080 — dan perkhidmatan lain menerimanya dalam pemboleh ubah, RIVERVO_API_URL. Cara ia berfungsi, perkhidmatan dalaman sahaja, beberapa instans dan had masa: Komunikasi antara perkhidmatan.
Setiap perkhidmatan mendapat pemboleh ubah projek — termasuk sambungan pangkalan data — serta pemboleh ubahnya sendiri, yang mengatasi pemboleh ubah projek. Lihat Pemboleh ubah persekitaran.
Sumber dan harga
Setiap perkhidmatan mempunyai Memori, CPU dan Cakera sendiri, dengan harga seperti mana-mana aplikasi: $6.48 setiap GB memori dan $4.32 setiap teras CPU sebulan, dengan 10 GB cakera termasuk bagi setiap GB memori, kemudian $0.16 setiap GB. Sesebuah perkhidmatan boleh mempunyai sehingga 8 GB memori.
Apabila anda menambah perkhidmatan, harganya ditambahkan pada bil projek — bagi bulan semasa hanya untuk baki bulan itu. Semasa projek dalam tempoh percubaan percuma, perkhidmatan baharu adalah percuma sehingga tempoh percubaan tamat.
Gambaran keseluruhan menunjukkan Jumlah projek — kos semua perkhidmatan projek sebulan bersama-sama.
Pekerja dalam aplikasi itu sendiri
Anda tidak selalu memerlukan perkhidmatan berasingan. Tab Proses aplikasi utama mempunyai:
- Pekerja latar belakang — sehingga 5 proses jangka panjang di samping laman web, contohnya pekerja baris gilir. Ia berkongsi sumber aplikasi dan dimulakan semula pada setiap deploy.
- Arahan berjadual — sehingga 10 arahan mengikut jadual (format cron, UTC). Outputnya ada dalam log di bawah Jadual.
- Konsol — jalankan arahan sekali sahaja di dalam aplikasi yang sedang berjalan, dengan pemboleh ubah dan pangkalan datanya. Arahan boleh berjalan sehingga 15 minit; arahan interaktif (tinker, shell) tidak disokong di sini.
Perkhidmatan berasingan ialah pilihan yang lebih baik apabila pekerja memerlukan sumbernya sendiri, supaya baris gilir yang berat tidak pernah memperlahankan laman web.
Menukar perkhidmatan
Buka perkhidmatan daripada senarai Perkhidmatan. Tetapannya mengandungi arahan, jadual, imej atau cawangan, serta sumbernya; perubahan disimpan dan perkhidmatan dimulakan semula dengannya. Setiap perkhidmatan juga mempunyai Log dan Pemantauan sendiri.