Kezdés

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.

5 PERC OLVASÁS

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ípusMi ez
Webszolgáltatásegy másik oldal vagy API – nyilvános címmel vagy csak belső eléréssel
Háttérfolyamatfolyamatosan 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, Valkeyfelü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.app cí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:work vagy node worker.js.
  • A webszolgáltatásnak a $PORT portjá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 $PORT vá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 a RIVERVO_<NAME>_URL=<service name>:9092 vá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.

Elakadtál?

Írj nekünk chaten — az AI azonnal válaszol, és ha kell, egy mérnök is bekapcsolódik, a nap bármely szakában.

Ügyfélszolgálat