Začít

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í.

5 MIN ČTENÍ

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

DruhCo to je
Webová službadalší web nebo API — s veřejnou adresou, nebo jen interní
Worker na pozadíběží nepřetržitě: fronty, Horizon, Celery, consumery
Plánovaná úlohaspouští se podle plánu (formát cron, UTC), udělá svou práci a skončí
PostgreSQL, MySQL, Valkeyspravované databáze — viz Databáze
NATS, RabbitMQmessage 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:work nebo node 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>:9092 a RIVERVO_<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.

Pořád si nevíte rady?

Napište nám do chatu — AI odpoví hned a technik se připojí, když je potřeba, v kteroukoli denní dobu.

Kontaktovat podporu