Egy projekt szolgáltatásai: webszolgáltatások, háttérfolyamatok és ütemezett feladatok.
Adj háttérfolyamatokat, ütemezett feladatokat, további webszolgáltatásokat, adatbázisokat és Valkeyt egy projekthez – a saját kódjából, egy másik tárolóból vagy kész image-ből –, név szerint elérhetően, egy számlán.
Egy projekt több egyetlen folyamatnál. A fő alkalmazás mellett futtathatsz sorfeldolgozót, éjszakai feladatot, külön API-t, adatbázist – mindegyiket szolgáltatásként, saját erőforrásokkal, mindet egy számlán.
A szolgáltatások az alkalmazás Áttekintés → Szolgáltatások → Szolgáltatás hozzáadása részén találhatók. Egy projektnek legfeljebb 10 szolgáltatása lehet. Előbb a fő szolgáltatást kell elindítani, és a projekt előfizetésének aktívnak kell lennie (a próbaidőszak is számít).
Szolgáltatástípusok
| Típus | Mi ez |
|---|---|
| Webszolgáltatás | egy másik oldal vagy API – nyilvános címmel vagy csak belső eléréssel |
| Háttérfolyamat | folyamatosan fut: sorok, Horizon, Celery, fogyasztók |
| Ütemezett feladat | ütemezés szerint indul (cron formátum, UTC), elvégzi a dolgát, és leáll |
| PostgreSQL, MySQL, Valkey | felügyelt adatbázisok – lásd: Adatbázisok |
| NATS, RabbitMQ | üzenetközvetítők eseményekhez és sorokhoz, csak belső eléréssel – lásd: Események és sorok |
Nyilvános cím vagy csak belső elérés
Amikor webszolgáltatást adsz hozzá, válaszd ki, hogyan érhető el – előre semmi nincs kiválasztva:
- Nyilvános cím – az internetről elérhető a
https://<name>.rivervo.appcímen; saját domainjei is lehetnek. - Csak belső – nincs címe az interneten és nincsenek domainjei; csak az alkalmazás többi szolgáltatása éri el. Jó választás egy oldalad mögötti API-hoz, admin backendhez vagy keresőmotorhoz.
A háttérfolyamatok, az ütemezett feladatok és az adatbázisok soha nem nyilvánosak, így náluk nincs választás. Később a szolgáltatás Beállítások → Nyilvános cím részén módosíthatod – lásd: Szolgáltatások közötti kommunikáció.
Honnan jön a kód
A projekt saját kódja
Ugyanaz a kód másképp indítva: sorfeldolgozó, ütemező, WebSocket-szerver (például Laravel Reverb), egy monorepó mappája, külön API.
- A Parancs kötelező – amit a szolgáltatás futtat, például
php artisan queue:workvagynode worker.js. - A webszolgáltatásnak a
$PORTportján kell figyelnie. - Az ütemezett feladathoz Ütemezés is kell cron formátumban (UTC), például
*/5 * * * *. - A fő szolgáltatás minden új verzióját ezekre a szolgáltatásokra is telepítjük, így mindig ugyanazt a kódot futtatják.
Másik tároló
Webszolgáltatás vagy háttérfolyamat a csatlakoztatott Git-fiókod egy másik tárolójából, saját ágával, és szükség esetén Projektmappával és Build- és indítóparancsokkal (hagyd üresen a mezőt, ha a felismertet szeretnéd). Saját telepítései és verziói vannak, és az ágára érkező minden pusht telepíti. Ágelőnézetek szolgáltatásokhoz egyelőre nem készülnek.
Kész image
Webszolgáltatás vagy háttérfolyamat egy kész image-ből (Docker image) a Docker Hubról, a GitHub Container Registryből vagy bármely más registryből – például nginx:1.27 vagy ghcr.io/org/app:tag.
- Port – a port, amelyen az image figyel; a
$PORTváltozóban is átadjuk. - Parancs – nem kötelező; üresen az image úgy indul, ahogy építették.
- Privát registry – felhasználónév és jelszó vagy hozzáférési token. Titkosítva tároljuk őket, csak az image letöltéséhez használjuk, és soha többé nem jelenítjük meg.
- Bekapcsolt automatikus telepítéssel naponta egyszer ellenőrizzük, hogy a tag újabb verzióra mutat-e, és telepítjük. A Telepítések fülön az Image újbóli letöltése ezt azonnal elvégzi.
Kafka (sablon)
A Szolgáltatás hozzáadása részben a Kafka egykattintásos előbeállítás: szolgáltatást hoz létre a hivatalos Apache Kafka image-ből (3.9) – egyetlen broker KRaft módban, ZooKeeper nélkül. Fejlesztéshez és mérsékelt terheléshez való.
- Csak belső – nincs nyilvános címe és külső elérése; csak az alkalmazás szolgáltatásai érik el.
- Az alkalmazás többi kódalapú szolgáltatása megkapja a
KAFKA_BROKERS=<service name>:9092és aRIVERVO_<NAME>_URL=<service name>:9092változót. - A topicok automatikusan létrejönnek az első használatkor.
- 1 GB memóriával · 1 CPU-maggal · 10 GB lemezzel indul. Mint minden kész image-ből indított szolgáltatásnál, az erőforrásait és a változóit módosíthatod.
- Az adatai a szolgáltatás lemezén, az adatmappájában vannak.
Ami nincs benne:
- Egy broker – nincs replikáció; minden topic replikációs tényezője 1.
- Nincs felügyelt Kafka-mentés. A napi biztonsági mentés fájlokként másolja az adatmappáját, miközben a Kafka fut. Ez nem konzisztens Kafka-mentés: visszaállítás után hiányozhatnak a legutóbbi üzenetek, vagy a Kafkának induláskor helyre kell állítania a naplóit.
- Nincs karbantartási időablak, külső elérés és Kafka UI.
- A Kafka frissítése a te feladatod: módosítsd az image-et a szolgáltatás Beállítások részén.
Biztonsági mentéssel és helyetted beállított kapcsolati változókkal működő sorokhoz és eseményekhez lásd: Események és sorok – NATS és RabbitMQ.
Elérés név szerint
Egy projekt szolgáltatásai privát hálózaton, név szerint kommunikálnak: az api nevű szolgáltatás a többiből api néven érhető el, a db nevű adatbázis db néven, a fő szolgáltatás pedig web néven. A projekt szolgáltatásai közötti forgalom nem számít bele a forgalomba.
Minden webszolgáltatás mutatja a Belső címét – például http://api:8080 –, és a többi szolgáltatás egy változóban, a RIVERVO_API_URL változóban kapja meg. Hogyan működik, csak belső szolgáltatások, több példány és időkorlátok: Szolgáltatások közötti kommunikáció.
Minden szolgáltatás megkapja a projekt változóit – az adatbázis-kapcsolatot is –, valamint a saját változóit, amelyek felülírják a projektéit. Lásd: Környezeti változók.
Erőforrások és ár
Minden szolgáltatásnak saját Memóriája, CPU-ja és Lemeze van, ugyanúgy árazva, mint bármely alkalmazás: 253 881 Ft / GB memória és 169 254 Ft / CPU-mag havonta, memória-GB-onként 10 GB lemezzel az árban, utána 6347 Ft / GB. Egy szolgáltatásnak legfeljebb 8 GB memóriája lehet.
Amikor szolgáltatást adsz hozzá, az ára hozzáadódik a projekt számlájához – az aktuális hónapra csak a hátralévő részre. Amíg a projekt ingyenes próbaidőszakban van, az új szolgáltatások a próbaidőszak végéig ingyenesek.
Az Áttekintés a Projekt összesen értéket mutatja – a projekt összes szolgáltatásának együttes havi költségét.
Háttérfolyamatok magában az alkalmazásban
Nem mindig kell külön szolgáltatás. A fő alkalmazás Folyamatok fülén ezek vannak:
- Háttérfolyamatok – legfeljebb 5 hosszan futó folyamat az oldal mellett, például egy sorfeldolgozó. Az alkalmazás erőforrásait használják, és minden telepítéskor újraindulnak.
- Ütemezett parancsok – legfeljebb 10 parancs ütemezés szerint (cron formátum, UTC). A kimenetük a naplóban az Ütemezés alatt található.
- Konzol – egyszeri parancs futtatása a futó alkalmazásban, annak változóival és adatbázisával. Egy parancs legfeljebb 15 percig futhat; interaktív parancsokat (tinker, shell) itt nem támogatunk.
Külön szolgáltatás akkor a jobb választás, ha egy háttérfolyamatnak saját erőforrás kell, hogy egy nagy terhelésű sor soha ne lassítsa az oldalt.
Szolgáltatás módosítása
Nyisd meg a szolgáltatást a Szolgáltatások listájából. A Beállítások tartalmazzák a parancsot, az ütemezést, az image-et vagy az ágat és az erőforrásait; a módosításokat mentjük, és a szolgáltatás velük újraindul. Minden szolgáltatásnak saját Naplók és Monitorozás füle is van.