Serviciile unui proiect: servicii web, workeri și sarcini programate.
Adaugă într-un proiect workeri de fundal, sarcini programate, alte servicii web, baze de date și Valkey — din codul proiectului, din alt repository sau dintr-o imagine gata făcută — accesibile după nume și pe o singură factură.
Un proiect înseamnă mai mult decât un singur proces. Pe lângă aplicația principală poți rula un worker de coadă, o sarcină de noapte, un API separat, o bază de date — fiecare ca serviciu cu resurse proprii, toate pe o singură factură.
Serviciile sunt în aplicație, la Prezentare generală → Servicii → Adaugă un serviciu. Un proiect poate avea cel mult 10 servicii. Serviciul principal trebuie lansat primul, iar abonamentul proiectului trebuie să fie activ (perioada de probă se pune).
Tipuri de servicii
| Tip | Ce este |
|---|---|
| Serviciu web | încă un site sau API — cu adresă publică sau doar intern |
| Worker de fundal | rulează tot timpul: cozi, Horizon, Celery, consumatori |
| Sarcină programată | pornește după un program (format cron, UTC), își face treaba și se oprește |
| PostgreSQL, MySQL, Valkey | baze de date administrate — vezi Baze de date |
| NATS, RabbitMQ | brokeri de mesaje pentru evenimente și cozi, doar interni — vezi Evenimente și cozi |
Adresă publică sau doar intern
Când adaugi un serviciu web, alege cum poate fi accesat — nimic nu este bifat dinainte:
- Adresă publică — deschis din internet la
https://<name>.rivervo.app; poate avea domeniile tale. - Doar intern — fără adresă pe internet și fără domenii; ajung la el doar celelalte servicii ale aplicației. Potrivit pentru un API din spatele site-ului, un backend de administrare sau un motor de căutare.
Workerii de fundal, sarcinile programate și bazele de date nu sunt niciodată publice, așa că pentru ele nu ai de ales. Poți schimba ulterior din Setări → Adresă publică ale serviciului — vezi Comunicarea între servicii.
De unde vine codul
Codul acestui proiect
Același cod, pornit altfel: un worker de coadă, un planificator, un server WebSocket (de exemplu Laravel Reverb), un folder dintr-un monorepo, un API separat.
- Comandă este obligatorie — ce rulează serviciul, de exemplu
php artisan queue:worksaunode worker.js. - Un serviciu web trebuie să asculte pe portul din
$PORT. - O sarcină programată are nevoie și de un Program în format cron (UTC), de exemplu
*/5 * * * *. - Fiecare versiune nouă a serviciului principal este publicată și pe aceste servicii, așa că ele rulează mereu același cod.
Alt repository
Un serviciu web sau un worker de fundal dintr-un alt repository al contului Git conectat, cu propriul branch și, dacă e nevoie, Folder proiect și Comenzi de build și pornire (lasă un câmp gol ca să folosești ce detectăm noi). Are propriile publicări și versiuni și publică fiecare push în branchul lui. Previzualizările de branch nu se fac încă pentru servicii.
O imagine gata făcută
Un serviciu web sau un worker de fundal dintr-o imagine gata făcută (imagine Docker) de pe Docker Hub, GitHub Container Registry sau orice alt registru — de exemplu nginx:1.27 sau ghcr.io/org/app:tag.
- Port — portul pe care ascultă imaginea; îl transmitem și în
$PORT. - Comandă — opțională; dacă e goală, imaginea pornește așa cum a fost construită.
- Registru privat — un nume de utilizator și o parolă sau un token de acces. Sunt stocate criptat, folosite doar pentru descărcarea imaginii și nu mai sunt afișate niciodată.
- Cu publicările automate activate, verificăm o dată pe zi dacă tagul indică o versiune mai nouă și o publicăm. Descarcă din nou imaginea din fila Publicări face asta imediat.
Kafka (șablon)
Kafka din Adaugă un serviciu este o presetare dintr-un clic: creează un serviciu din imaginea oficială Apache Kafka (3.9) — un singur broker în modul KRaft, fără ZooKeeper. Este potrivit pentru dezvoltare și încărcări moderate.
- Doar intern — fără adresă publică și fără acces din exterior; ajung la el doar serviciile aplicației.
- Celelalte servicii cu cod ale aplicației primesc
KAFKA_BROKERS=<service name>:9092șiRIVERVO_<NAME>_URL=<service name>:9092. - Topicurile se creează automat la prima folosire.
- Pornește cu 1 GB de memorie · 1 nucleu CPU · 10 GB de disc. Ca la orice serviciu dintr-o imagine gata făcută, îi poți schimba resursele și variabilele.
- Datele lui se păstrează în folderul de date al serviciului, pe discul lui.
Ce nu are:
- Un singur broker — fără replicare; fiecare topic are factorul de replicare 1.
- Fără backupuri Kafka administrate. Backupul zilnic copiază folderul de date ca fișiere în timp ce Kafka rulează. Nu este un backup Kafka consistent: după o restaurare pot lipsi mesajele recente sau Kafka poate avea nevoie să-și refacă logurile la pornire.
- Fără fereastră de mentenanță, fără acces din exterior și fără interfață Kafka.
- Actualizarea Kafka rămâne în grija ta: schimbă imaginea în Setări ale serviciului.
Pentru cozi și evenimente cu backupuri și variabile de conexiune configurate pentru tine, vezi Evenimente și cozi — NATS și RabbitMQ.
Accesul unul la altul după nume
Serviciile unui proiect comunică într-o rețea privată după nume: un serviciu numit api este accesibil din celelalte ca api, o bază de date numită db ca db, iar serviciul principal ca web. Traficul dintre serviciile unui proiect nu se socotește trafic.
Fiecare serviciu web își afișează Adresa internă — de exemplu http://api:8080 — iar celelalte servicii o primesc într-o variabilă, RIVERVO_API_URL. Cum funcționează, serviciile doar interne, instanțele multiple și timeouturile: Comunicarea între servicii.
Fiecare serviciu primește variabilele proiectului — inclusiv conexiunea la baza de date — plus variabilele proprii, care au prioritate față de cele ale proiectului. Vezi Variabile de mediu.
Resurse și preț
Fiecare serviciu are propriile Memorie, CPU și Disc, cu prețuri ca la orice aplicație: 6,61 € pe GB de memorie și 4,40 € pe nucleu CPU pe lună, cu 10 GB de disc incluși pentru fiecare GB de memorie, apoi 0,17 € pe GB. Un serviciu poate avea cel mult 8 GB de memorie.
Când adaugi un serviciu, prețul lui se adaugă la factura proiectului — pentru luna curentă doar partea rămasă din ea. Cât timp proiectul este în perioada de probă gratuită, serviciile noi sunt gratuite până la finalul ei.
Prezentare generală afișează Total proiect — cât costă împreună, pe lună, toate serviciile proiectului.
Workeri chiar în aplicație
Nu ai mereu nevoie de un serviciu separat. Fila Procese a aplicației principale are:
- Workeri de fundal — până la 5 procese de lungă durată lângă site, de exemplu un worker de coadă. Folosesc resursele aplicației și repornesc la fiecare publicare.
- Comenzi programate — până la 10 comenzi după un program (format cron, UTC). Rezultatul lor apare în log, la Program.
- Consolă — rulează o comandă o singură dată în aplicația care rulează, cu variabilele și baza ei de date. O comandă poate rula până la 15 minute; comenzile interactive (tinker, un shell) nu sunt suportate aici.
Un serviciu separat e alegerea mai bună când un worker are nevoie de resurse proprii, ca o coadă grea să nu încetinească niciodată site-ul.
Modificarea unui serviciu
Deschide serviciul din lista Servicii. În Setări găsești comanda, programul, imaginea sau branchul și resursele lui; modificările se salvează, iar serviciul repornește cu ele. Fiecare serviciu are și propriile file Loguri și Monitorizare.