Započnite

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

Dodajte projektu pozadinske procese, zakazane zadatke, dodatne veb servise, baze podataka i Valkey — iz njegovog koda, drugog repozitorijuma ili gotove slike — dostupne po imenu i na jednom računu.

5 MIN ČITANJA

Projekat je više od jednog procesa. Pored glavne aplikacije možete pokrenuti queue worker, noćni zadatak, zaseban API, bazu podataka — svako kao servis sa sopstvenim resursima, sve na jednom računu.

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

Vrste servisa

VrstaŠta je to
Veb servisjoš jedan sajt ili API — sa javnom adresom ili samo interni
Pozadinski procesradi stalno: redovi, Horizon, Celery, consumeri
Zakazani zadatakpokreće se po rasporedu (cron format, UTC), obavi posao i zaustavlja se
PostgreSQL, MySQL, Valkeyupravljane baze podataka — pogledajte Baze podataka
NATS, RabbitMQbrokeri poruka za događaje i redove, samo interni — pogledajte Događaji i redovi

Javna adresa ili samo interni

Kada dodajete veb servis, izaberite kako mu se pristupa — ništa nije unapred izabrano:

  • Javna adresa — dostupan sa interneta na https://<name>.rivervo.app; može imati vaše domene.
  • Samo interni — bez adrese na internetu i bez domena; pristupaju mu samo ostali servisi aplikacije. Pogodno za API iza vašeg sajta, administratorski backend ili pretraživač.

Pozadinski procesi, zakazani zadaci i baze podataka nikada nisu javni, pa za njih nema izbora. Kasnije to možete promeniti u servisu: Podešavanja → Javna adresa — pogledajte Komunikacija između servisa.

Odakle dolazi kod

Kod ovog projekta

Isti kod pokrenut na drugi način: queue worker, planer, WebSocket server (na primer Laravel Reverb), folder monorepozitorijuma, zaseban API.

  • Komanda je obavezna — ono što servis pokreće, npr. php artisan queue:work ili node worker.js.
  • Veb servis mora da sluša na portu iz $PORT.
  • Zakazanom zadatku potreban je i Raspored u cron formatu (UTC), npr. */5 * * * *.
  • Svaka nova verzija glavnog servisa postavlja se i na ove servise, tako da uvek pokreću isti kod.

Drugi repozitorijum

Veb servis ili pozadinski proces iz drugog repozitorijuma vašeg povezanog Git naloga, sa sopstvenom granom i, po potrebi, Folderom projekta i Komandama za gradnju i pokretanje (ostavite polje prazno da biste koristili ono što prepoznamo). Ima sopstvene deploye i verzije i radi deploy pri svakom pushu na svoju granu. Pregledi grana za servise se još ne prave.

Gotova slika

Veb servis ili pozadinski proces iz gotove slike (Docker image) sa Docker Huba, GitHub Container Registryja ili bilo kog drugog registra — na primer nginx:1.27 ili ghcr.io/org/app:tag.

  • Port — port na kojem slika sluša; prosleđujemo ga i u $PORT.
  • Komanda — opciono; ako je prazna, slika se pokreće onako kako je napravljena.
  • Privatni registar — korisničko ime i lozinka ili pristupni token. Čuvaju se šifrovani, koriste se samo za preuzimanje slike i više se nikada ne prikazuju.
  • Kada su automatski deployi uključeni, jednom dnevno proveravamo da li tag pokazuje na noviju verziju i radimo njen deploy. Ponovo preuzmi sliku na kartici Deployi to radi odmah.

Kafka (šablon)

Kafka u Dodaj servis je gotova postavka na jedan klik: pravi servis iz zvanične Apache Kafka slike (3.9) — jedan broker u KRaft režimu, bez ZooKeepera. Pogodna je za razvoj i umerena opterećenja.

  • Samo interni — bez javne adrese i bez pristupa spolja; pristupaju mu samo servisi aplikacije.
  • Ostali servisi sa kodom u aplikaciji dobijaju KAFKA_BROKERS=<service name>:9092 i RIVERVO_<NAME>_URL=<service name>:9092.
  • Topici se prave automatski pri prvoj upotrebi.
  • Počinje sa 1 GB memorije · 1 procesorskim jezgrom · 10 GB diska. Kao i kod svakog servisa iz gotove slike, možete menjati njegove resurse i promenljive.
  • Njeni podaci se čuvaju u folderu za podatke servisa na njegovom disku.

Šta nema:

  • Jedan broker — bez replikacije; svaki topic ima faktor replikacije 1.
  • Nema upravljanih Kafka rezervnih kopija. Dnevna rezervna kopija kopira folder za podatke kao fajlove dok Kafka radi. To nije konzistentna Kafka rezervna kopija: posle vraćanja mogu nedostajati skorašnje poruke ili će Kafka možda morati da oporavi svoje logove pri pokretanju.
  • Nema termina za održavanje, pristupa spolja ni Kafka UI.
  • Nadogradnja Kafke je na vama: promenite sliku u Podešavanjima servisa.

Za redove i događaje sa rezervnim kopijama i već podešenim promenljivama za povezivanje pogledajte Događaji i redovi — NATS i RabbitMQ.

Pristup jedni drugima po imenu

Servisi projekta komuniciraju preko privatne mreže po imenu: servisu po imenu api ostali pristupaju kao api, bazi po imenu db kao db, a glavnom servisu kao web. Saobraćaj između servisa projekta ne računa se kao saobraćaj.

Svaki veb servis prikazuje svoju Internu adresu — na primer http://api:8080 — a ostali servisi je dobijaju u promenljivoj RIVERVO_API_URL. Kako to radi, samo interni servisi, više instanci i vremenski limiti: Komunikacija između servisa.

Svaki servis dobija promenljive projekta — uključujući vezu sa bazom — plus sopstvene promenljive, koje imaju prednost nad promenljivama projekta. Pogledajte Promenljive okruženja.

Resursi i cena

Svaki servis ima sopstvenu Memoriju, Procesor i Disk, sa cenom kao i svaka aplikacija: 5,46 € po GB memorije i 3,64 € po procesorskom jezgru mesečno, sa 10 GB diska uključenih po GB memorije, a zatim 0,14 € po GB. Servis može imati do 8 GB memorije.

Kada dodate servis, njegova cena se dodaje na račun projekta — za tekući mesec samo preostali deo. Dok je projekat u besplatnom probnom periodu, novi servisi su besplatni do kraja probnog perioda.

Pregled prikazuje Ukupno za projekat — koliko svi servisi projekta zajedno koštaju mesečno.

Pozadinski procesi unutar same aplikacije

Zaseban servis nije uvek potreban. Kartica Procesi glavne aplikacije ima:

  • Pozadinski procesi — do 5 dugotrajnih procesa pored sajta, npr. queue worker. Dele resurse aplikacije i restartuju se pri svakom deployu.
  • Zakazane komande — do 10 komandi po rasporedu (cron format, UTC). Njihov izlaz je u logu pod Raspored.
  • Konzola — pokrenite jednokratnu komandu unutar pokrenute aplikacije, sa njenim promenljivama i bazom. Komanda može da radi do 15 minuta; interaktivne komande (tinker, shell) ovde nisu podržane.

Zaseban servis je bolji izbor kada worker treba sopstvene resurse, kako zahtevan red nikada ne bi usporio sajt.

Izmena servisa

Otvorite servis sa liste Servisi. U njegovim Podešavanjima su komanda, raspored, slika ili grana i resursi; izmene se čuvaju i servis se restartuje sa njima. Svaki servis ima i sopstvene Logove i Praćenje.

I dalje vam treba pomoć?

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

Kontaktirajte podršku