Služby projektu: webové služby, workery a plánované úlohy.
Přidejte do projektu workery na pozadí, plánované úlohy, další webové služby, databáze a Valkey — z vlastního kódu, jiného repozitáře nebo hotového image — dostupné podle názvu a na jednom vyúčtování.
Projekt je víc než jeden proces. Vedle hlavní aplikace můžete provozovat worker fronty, noční úlohu, samostatné API nebo databázi — každou jako službu s vlastními prostředky, vše na jednom vyúčtování.
Služby najdete v aplikaci v Přehled → Služby → Přidat službu. Projekt může mít až 10 služeb. Hlavní služba musí být spuštěná jako první a předplatné projektu musí být aktivní (zkušební období se počítá).
Druhy služeb
| Druh | Co to je |
|---|---|
| Webová služba | další web nebo API — s veřejnou adresou, nebo jen interní |
| Worker na pozadí | běží nepřetržitě: fronty, Horizon, Celery, consumery |
| Plánovaná úloha | spouští se podle plánu (formát cron, UTC), udělá svou práci a skončí |
| PostgreSQL, MySQL, Valkey | spravované databáze — viz Databáze |
| NATS, RabbitMQ | message brokery pro události a fronty, jen interní — viz Události a fronty |
Veřejná adresa, nebo jen interní
Když přidáváte webovou službu, zvolte, jak bude dostupná — předem není vybráno nic:
- Veřejná adresa — dostupná z internetu na
https://<name>.rivervo.app; může mít vlastní domény. - Pouze interní — žádná adresa v internetu ani domény; dostanou se k ní jen ostatní služby aplikace. Hodí se pro API za vaším webem, administrační backend nebo vyhledávač.
Workery na pozadí, plánované úlohy a databáze nejsou nikdy veřejné, takže u nich se nic nevolí. Později to můžete změnit v Nastavení služby → Veřejná adresa — viz Komunikace mezi službami.
Odkud pochází kód
Kód tohoto projektu
Stejný kód spuštěný jiným způsobem: worker fronty, plánovač, WebSocket server (například Laravel Reverb), složka monorepozitáře, samostatné API.
- Příkaz je povinný — co služba spouští, např.
php artisan queue:worknebonode worker.js. - Webová služba musí naslouchat na portu z
$PORT. - Plánovaná úloha potřebuje navíc Plán ve formátu cron (UTC), např.
*/5 * * * *. - Každá nová verze hlavní služby se nasadí i do těchto služeb, takže vždy běží stejný kód.
Jiný repozitář
Webová služba nebo worker na pozadí z jiného repozitáře vašeho připojeného účtu Git, s vlastní větví a v případě potřeby se Složkou projektu a Příkazy pro sestavení a spuštění (prázdné pole znamená, že se použije, co rozpoznáme). Má vlastní nasazení a verze a nasazuje každý push do své větve. Náhledy větví se u služeb zatím nevytvářejí.
Hotový image
Webová služba nebo worker na pozadí z hotového image (Docker image) na Docker Hubu, v GitHub Container Registry nebo v jakémkoli jiném registru — například nginx:1.27 nebo ghcr.io/org/app:tag.
- Port — port, na kterém image naslouchá; předáme ho i v
$PORT. - Příkaz — nepovinný; když je prázdný, image se spustí tak, jak byl sestaven.
- Soukromý registr — uživatelské jméno a heslo nebo přístupový token. Ukládají se šifrovaně, slouží jen ke stažení image a už se nikdy nezobrazí.
- Při zapnutém automatickém nasazování jednou denně zkontrolujeme, zda tag neukazuje na novější verzi, a pokud ano, nasadíme ji. Znovu stáhnout image na kartě Nasazení to udělá hned.
Kafka (šablona)
Kafka v nabídce Přidat službu je předvolba na jedno kliknutí: vytvoří službu z oficiálního image Apache Kafka (3.9) — jeden broker v režimu KRaft, bez ZooKeeperu. Hodí se pro vývoj a střední zátěž.
- Pouze interní — žádná veřejná adresa ani přístup zvenčí; dostanou se k ní jen služby aplikace.
- Ostatní kódové služby aplikace dostanou
KAFKA_BROKERS=<service name>:9092aRIVERVO_<NAME>_URL=<service name>:9092. - Topicy se vytvoří automaticky při prvním použití.
- Začíná s 1 GB paměti · 1 jádrem CPU · 10 GB disku. Jako u každé služby z hotového image můžete měnit její prostředky a proměnné.
- Data se ukládají do datové složky služby na jejím disku.
Co nemá:
- Jeden broker — žádná replikace; každý topic má replikační faktor 1.
- Žádné spravované zálohy Kafky. Denní záloha kopíruje datovou složku jako soubory za běhu Kafky. Není to konzistentní záloha Kafky: po obnovení mohou chybět nedávné zprávy, nebo může Kafka při startu potřebovat obnovit své logy.
- Žádné okno údržby, žádný přístup zvenčí a žádné Kafka UI.
- Aktualizace Kafky je na vás: změňte image v Nastavení služby.
Fronty a události se zálohami a připojovacími proměnnými nastavenými za vás najdete v článku Události a fronty — NATS a RabbitMQ.
Vzájemná dostupnost podle názvu
Služby projektu spolu komunikují přes privátní síť podle názvu: služba api je pro ostatní dostupná jako api, databáze db jako db a hlavní služba jako web. Provoz mezi službami projektu se do provozu nezapočítává.
Každá webová služba ukazuje svou Interní adresu — například http://api:8080 — a ostatní služby ji dostanou v proměnné RIVERVO_API_URL. Jak to funguje, služby pouze interní, více instancí a timeouty: Komunikace mezi službami.
Každá služba dostává proměnné projektu — včetně připojení k databázi — a k tomu vlastní proměnné, které mají přednost před proměnnými projektu. Viz Proměnné prostředí.
Prostředky a cena
Každá služba má vlastní Paměť, CPU a Disk s cenou jako u každé aplikace: 161,06 Kč za GB paměti a 107,38 Kč za jádro CPU měsíčně, s 10 GB disku v ceně na každý GB paměti, dál 4,03 Kč za GB. Služba může mít až 8 GB paměti.
Když službu přidáte, její cena se připočte k vyúčtování projektu — za aktuální měsíc jen za zbývající část. Dokud je projekt ve zkušebním období zdarma, nové služby jsou zdarma až do jeho konce.
Přehled ukazuje Celkem za projekt — kolik stojí všechny služby projektu dohromady za měsíc.
Workery přímo v aplikaci
Samostatnou službu nepotřebujete vždycky. Karta Procesy hlavní aplikace nabízí:
- Workery na pozadí — až 5 dlouho běžících procesů vedle webu, např. worker fronty. Sdílejí prostředky aplikace a restartují se s každým nasazením.
- Plánované příkazy — až 10 příkazů podle plánu (formát cron, UTC). Jejich výstup najdete v logu pod Plán.
- Konzole — jednorázový příkaz uvnitř běžící aplikace, s jejími proměnnými a databází. Příkaz může běžet až 15 minut; interaktivní příkazy (tinker, shell) tu podporované nejsou.
Samostatná služba je lepší volba, když worker potřebuje vlastní prostředky, aby náročná fronta nikdy nezpomalila web.
Změna služby
Službu otevřete ze seznamu Služby. V jejím Nastavení je příkaz, plán, image nebo větev a její prostředky; změny se uloží a služba se s nimi restartuje. Každá služba má také vlastní Logy a Monitoring.