Služby projektu: webové služby, procesy na pozadí a plánované úlohy.
Pridajte do projektu procesy na pozadí, plánované úlohy, ďalšie webové služby, databázy a Valkey — z vlastného kódu, iného repozitára alebo hotového obrazu —, dostupné podľa názvu a na jednej faktúre.
Projekt nie je len jeden proces. Popri hlavnej aplikácii môžete spustiť spracovanie fronty, nočnú úlohu, samostatné API, databázu — každú ako službu s vlastnými prostriedkami, všetko na jednej faktúre.
Služby nájdete v Prehľade aplikácie → Služby → Pridať službu. Projekt môže mať najviac 10 služieb. Hlavná služba musí byť spustená ako prvá a predplatné projektu musí byť aktívne (skúšobné obdobie sa počíta).
Druhy služieb
| Druh | Čo to je |
|---|---|
| Webová služba | ďalší web alebo API — s verejnou adresou alebo len interná |
| Proces na pozadí | beží stále: fronty, Horizon, Celery, konzumenti |
| Plánovaná úloha | spustí sa podľa plánu (formát cron, UTC), urobí svoju prácu a skončí |
| PostgreSQL, MySQL, Valkey | spravované databázy — pozrite Databázy |
| NATS, RabbitMQ | message brokery pre udalosti a fronty, len interné — pozrite Udalosti a fronty |
Verejná adresa alebo len interná
Keď pridávate webovú službu, zvoľte, ako bude dostupná — nič nie je predvybrané:
- Verejná adresa — otvorená z internetu na
https://<name>.rivervo.app; môže mať vlastné domény. - Len interná — žiadna adresa na internete a žiadne domény; dostanú sa k nej len ostatné služby aplikácie. Vhodné pre API za vaším webom, administračný backend alebo vyhľadávač.
Procesy na pozadí, plánované úlohy a databázy nie sú nikdy verejné, takže pri nich sa nevyberá. Zmeniť to môžete neskôr v Nastaveniach služby → Verejná adresa — pozrite Komunikácia medzi službami.
Odkiaľ pochádza kód
Kód tohto projektu
Ten istý kód spustený inak: spracovanie fronty, plánovač, WebSocket server (napríklad Laravel Reverb), priečinok monorepozitára, samostatné API.
- Príkaz je povinný — čo služba spúšťa, napr.
php artisan queue:workalebonode worker.js. - Webová služba musí počúvať na porte z
$PORT. - Plánovaná úloha potrebuje aj Plán vo formáte cron (UTC), napr.
*/5 * * * *. - Každá nová verzia hlavnej služby sa nasadí aj do týchto služieb, takže vždy bežia na rovnakom kóde.
Iný repozitár
Webová služba alebo proces na pozadí z iného repozitára vášho pripojeného Git účtu, s vlastnou vetvou a podľa potreby Priečinkom projektu a Príkazmi zostavenia a spustenia (prázdne pole znamená, že sa použije to, čo rozpoznáme). Má vlastné nasadenia a verzie a nasadí každý push do svojej vetvy. Náhľady vetiev sa pre služby zatiaľ nevytvárajú.
Hotový obraz
Webová služba alebo proces na pozadí z hotového obrazu (Docker image) na Docker Hub, GitHub Container Registry alebo v inom registri — napríklad nginx:1.27 alebo ghcr.io/org/app:tag.
- Port — port, na ktorom obraz počúva; odovzdáme ho aj v
$PORT. - Príkaz — nepovinný; prázdny spustí obraz tak, ako bol zostavený.
- Súkromný register — používateľské meno a heslo alebo prístupový token. Ukladajú sa šifrovane, používajú sa len na stiahnutie obrazu a už sa nikdy nezobrazia.
- So zapnutým automatickým nasadzovaním raz denne overíme, či tag ukazuje na novšiu verziu, a nasadíme ju. Stiahnuť obraz znova na karte Nasadenia to urobí hneď.
Kafka (šablóna)
Kafka v Pridať službu je predvoľba na jedno kliknutie: vytvorí službu z oficiálneho obrazu Apache Kafka (3.9) — jeden broker v režime KRaft, bez ZooKeepera. Hodí sa na vývoj a stredné záťaže.
- Len interná — žiadna verejná adresa ani prístup zvonku; dostanú sa k nej len služby aplikácie.
- Ostatné kódové služby aplikácie dostanú
KAFKA_BROKERS=<service name>:9092aRIVERVO_<NAME>_URL=<service name>:9092. - Topiky sa vytvoria automaticky pri prvom použití.
- Začína s 1 GB pamäte · 1 jadrom CPU · 10 GB disku. Ako pri každej službe z hotového obrazu môžete meniť jej prostriedky a premenné.
- Jej dáta sa uchovávajú v dátovom priečinku služby na jej disku.
Čo nemá:
- Jeden broker — bez replikácie; každý topik má replikačný faktor 1.
- Žiadne spravované zálohy Kafky. Denná záloha kopíruje jej dátový priečinok ako súbory, kým Kafka beží. To nie je konzistentná záloha Kafky: po obnove môžu chýbať najnovšie správy alebo Kafka môže pri štarte potrebovať obnoviť svoje logy.
- Žiadne okno údržby, žiadny prístup zvonku a žiadne Kafka UI.
- Aktualizácia Kafky je na vás: zmeňte obraz v Nastaveniach služby.
Fronty a udalosti so zálohami a s premennými pripojenia nastavenými za vás nájdete v Udalosti a fronty — NATS a RabbitMQ.
Prístup k sebe podľa názvu
Služby projektu komunikujú cez súkromnú sieť podľa názvu: služba s názvom api je pre ostatné dostupná ako api, databáza db ako db a hlavná služba ako web. Prenos medzi službami projektu sa ako prenos nezapočítava.
Každá webová služba ukazuje svoju Internú adresu — napríklad http://api:8080 — a ostatné služby ju dostanú v premennej RIVERVO_API_URL. Ako to funguje, služby len interné, viac inštancií a časové limity: Komunikácia medzi službami.
Každá služba dostane premenné projektu — vrátane pripojenia k databáze — plus vlastné premenné, ktoré majú prednosť pred premennými projektu. Pozrite Premenné prostredia.
Prostriedky a cena
Každá služba má vlastnú Pamäť, CPU a Disk s cenou ako pri každej aplikácii: 6,72 € za GB pamäte a 4,48 € za jadro CPU mesačne, s 10 GB disku v cene na každý GB pamäte, potom 0,17 € za GB. Služba môže mať najviac 8 GB pamäte.
Keď pridáte službu, jej cena sa pripočíta k faktúre projektu — za aktuálny mesiac len za zostávajúcu časť. Kým je projekt v skúšobnom období zadarmo, nové služby sú zadarmo až do jeho konca.
Prehľad ukazuje Spolu za projekt — koľko stoja všetky služby projektu spolu mesačne.
Procesy priamo v aplikácii
Samostatnú službu nie vždy potrebujete. Karta Procesy hlavnej aplikácie má:
- Procesy na pozadí — najviac 5 dlhodobo bežiacich procesov popri webe, napr. spracovanie fronty. Zdieľajú prostriedky aplikácie a reštartujú sa pri každom nasadení.
- Plánované príkazy — najviac 10 príkazov podľa plánu (formát cron, UTC). Ich výstup je v logu pod Plánovač.
- Konzola — spustite jednorazový príkaz v bežiacej aplikácii, s jej premennými a databázou. Príkaz môže bežať najviac 15 minút; interaktívne príkazy (tinker, shell) tu nie sú podporované.
Samostatná služba je lepšou voľbou, keď proces potrebuje vlastné prostriedky, aby náročná fronta nikdy nespomalila web.
Zmena služby
Otvorte službu zo zoznamu Služby. V jej Nastaveniach je príkaz, plán, obraz alebo vetva a jej prostriedky; zmeny sa uložia a služba sa s nimi reštartuje. Každá služba má aj vlastné Logy a Monitorovanie.