Započnite

Servisi projekta: web servisi, pozadinski procesi i zakazani zadaci.

Dodajte projektu pozadinske procese, zakazane zadatke, dodatne web servise, baze podataka i Valkey — iz njegova koda, drugog repozitorija ili gotove slike — dostupne po nazivu i na jednom računu.

5 MIN ČITANJA

Projekt je više od jednog procesa. Uz glavnu aplikaciju možete pokrenuti pozadinski proces za red, noćni zadatak, zaseban API, bazu podataka — svaki kao servis s vlastitim resursima, sve na jednom računu.

Servisi su navedeni u aplikaciji pod Pregled → Servisi → Dodaj servis. Projekt može imati do 10 servisa. Glavni servis mora biti pokrenut prvi, a pretplata projekta mora biti aktivna (probno razdoblje se računa).

Vrste servisa

VrstaŠto je
Web servisjoš jedna stranica ili API — s javnom adresom ili samo interno
Pozadinski procesradi stalno: redovi, Horizon, Celery, potrošači
Zakazani zadatakpokreće se prema rasporedu (cron format, UTC), obavi posao i zaustavi se
PostgreSQL, MySQL, Valkeyupravljane baze podataka — pogledajte Baze podataka
NATS, RabbitMQmessage brokeri za događaje i redove, samo interno — pogledajte Događaji i redovi

Javna adresa ili samo interno

Kada dodajete web servis, odaberite kako mu se može pristupiti — ništa nije unaprijed odabrano:

  • Javna adresa — dostupan s interneta na https://<naziv>.rivervo.app; može imati vaše vlastite domene.
  • Samo interno — bez adrese na internetu i bez domena; do njega dolaze samo ostali servisi aplikacije. Prikladno za API iza vaše stranice, administracijski backend ili tražilicu.

Pozadinski procesi, zakazani zadaci i baze podataka nikad nisu javni, pa za njih nema izbora. Kasnije to možete promijeniti u servisu pod Postavke → Javna adresa — pogledajte Komunikacija među servisima.

Odakle dolazi kod

Kod ovog projekta

Isti kod pokrenut na drugi način: pozadinski proces za red, planer, WebSocket server (na primjer Laravel Reverb), mapa monorepozitorija, zaseban API.

  • Naredba je obavezna — ono što servis pokreće, npr. php artisan queue:work ili node worker.js.
  • Web servis mora slušati na portu iz $PORT.
  • Zakazani zadatak treba i Raspored u cron formatu (UTC), npr. */5 * * * *.
  • Svaka nova verzija glavnog servisa objavljuje se i na te servise, pa uvijek pokreću isti kod.

Drugi repozitorij

Web servis ili pozadinski proces iz drugog repozitorija vašeg povezanog Git računa, s vlastitom granom i, po potrebi, Mapom projekta i Naredbama izgradnje i pokretanja (ostavite polje prazno da biste koristili ono što prepoznamo). Ima vlastite deployeve i verzije i objavljuje svaki push na svoju granu. Pregledi grana za servise još se ne izrađuju.

Gotova slika

Web servis ili pozadinski proces iz gotove slike (Docker slike) na Docker Hubu, GitHub Container Registryju ili bilo kojem drugom registru — na primjer nginx:1.27 ili ghcr.io/org/app:tag.

  • Port — port na kojem slika sluša; prosljeđujemo ga i u $PORT.
  • Naredba — neobavezna; ako je prazna, slika se pokreće onako kako je izgrađena.
  • Privatni registar — korisničko ime i lozinka ili pristupni token. Pohranjuju se šifrirano, koriste se samo za preuzimanje slike i više se nikad ne prikazuju.
  • Kad su automatski deployevi uključeni, jednom dnevno provjeravamo pokazuje li oznaka na noviju verziju i objavljujemo je. Ponovno preuzmi sliku na kartici Deployevi to radi odmah.

Kafka (predložak)

Kafka u Dodaj servis je gotova postavka na jedan klik: izrađuje servis iz službene Apache Kafka slike (3.9) — jedan broker u KRaft načinu, bez ZooKeepera. Prikladna je za razvoj i umjerena opterećenja.

  • Samo interno — bez javne adrese i bez pristupa izvana; do nje dolaze samo servisi aplikacije.
  • Ostali servisi s kodom u aplikaciji dobivaju KAFKA_BROKERS=<naziv servisa>:9092 i RIVERVO_<NAZIV>_URL=<naziv servisa>:9092.
  • Topici se izrađuju automatski pri prvom korištenju.
  • Počinje s 1 GB memorije · 1 procesorskom jezgrom · 10 GB diska. Kao i kod svakog servisa iz gotove slike, možete promijeniti njezine resurse i varijable.
  • Njezini se podaci čuvaju u mapi podataka servisa na njegovu disku.

Što nema:

  • Jedan broker — bez replikacije; svaki topic ima faktor replikacije 1.
  • Nema upravljanih Kafka sigurnosnih kopija. Dnevna sigurnosna kopija kopira njezinu mapu podataka kao datoteke dok Kafka radi. To nije konzistentna Kafka sigurnosna kopija: nakon vraćanja mogu nedostajati nedavne poruke ili će Kafka možda morati oporaviti svoje zapise pri pokretanju.
  • Nema vremena održavanja, pristupa izvana ni Kafka sučelja.
  • Nadogradnja Kafke je na vama: promijenite sliku u servisu pod Postavke.

Za redove i događaje sa sigurnosnim kopijama i već postavljenim varijablama za povezivanje pogledajte Događaji i redovi — NATS i RabbitMQ.

Dostupnost po nazivu

Servisi projekta komuniciraju preko privatne mreže po nazivu: servis naziva api ostalima je dostupan kao api, baza podataka naziva db kao db, a glavni servis kao web. Promet između servisa projekta ne računa se kao promet.

Svaki web servis prikazuje svoju Internu adresu — na primjer http://api:8080 — a ostali servisi dobivaju je u varijabli RIVERVO_API_URL. Kako to radi, servisi samo za interni pristup, više instanci i vremena čekanja: Komunikacija među servisima.

Svaki servis dobiva varijable projekta — uključujući vezu s bazom podataka — te vlastite varijable, koje imaju prednost pred varijablama projekta. Pogledajte Varijable okruženja.

Resursi i cijena

Svaki servis ima vlastitu Memoriju, Procesor i Disk, s cijenom kao i svaka aplikacija: 6,81 € po GB memorije i 4,54 € po procesorskoj jezgri mjesečno, s 10 GB diska uključenih po GB memorije, a zatim 0,17 € po GB. Servis može imati do 8 GB memorije.

Kada dodate servis, njegova se cijena dodaje računu projekta — za tekući mjesec samo za preostali dio. Dok je projekt u besplatnom probnom razdoblju, novi servisi besplatni su do kraja probnog razdoblja.

Pregled prikazuje Ukupno za projekt — koliko svi servisi projekta zajedno stoje mjesečno.

Pozadinski procesi unutar same aplikacije

Ne treba vam uvijek zaseban servis. Kartica Procesi glavne aplikacije ima:

  • Pozadinski procesi — do 5 dugotrajnih procesa uz stranicu, npr. pozadinski proces za red. Dijele resurse aplikacije i ponovno se pokreću pri svakom deployu.
  • Zakazane naredbe — do 10 naredbi prema rasporedu (cron format, UTC). Njihov je ispis u zapisu pod Raspored.
  • Konzola — izvršite jednokratnu naredbu unutar pokrenute aplikacije, s njezinim varijablama i bazom podataka. Naredba može trajati do 15 minuta; interaktivne naredbe (tinker, shell) ovdje nisu podržane.

Zaseban servis bolji je izbor kada pozadinskom procesu trebaju vlastiti resursi, kako zahtjevan red nikad ne bi usporio stranicu.

Promjena servisa

Otvorite servis s popisa Servisi. Njegove Postavke sadrže naredbu, raspored, sliku ili granu te resurse; promjene se spremaju i servis se s njima ponovno pokreće. Svaki servis ima i vlastite kartice Zapisi i Nadzor.

Još uvijek zapelo?

Pišite nam u chat — AI odgovara odmah, a inženjer se uključuje kad je potrebno, u bilo koje doba dana.

Kontaktirajte podršku