Komunikacija među servisima: interne adrese i servisi samo za interni pristup.
Kako servisi jedne aplikacije dolaze jedni do drugih preko interne adrese, varijable RIVERVO_<NAME>_URL, servisi bez javne adrese, više instanci te vremena čekanja i ponovni pokušaji s primjerima za Node.js, Laravel i Python.
Servisi jedne aplikacije komuniciraju izravno, bez prolaska kroz internet. Stranica može pozivati vlastiti API, pozadinski proces može pozivati interni servis — a taj je promet besplatan: ne računa se kao promet.
Primjeri u nastavku koriste dva web servisa: web, stranicu koju otvaraju posjetitelji, s Javnom adresom, i api, koji pozivaju samo web i ostali servisi, postavljen na Samo interno.
Interna adresa
Svaki web servis — s javnom adresom ili samo interni — ima Internu adresu oblika http://<naziv-servisa>:<port>, na primjer http://api:8080. Prikazana je na stranici servisa i u Pregledu aplikacije, s gumbom za kopiranje i napomenom «Ostali servisi ove aplikacije dolaze do njega ovdje — bez interneta, bez naplate prometa.»
- Port je 8080 za servis izgrađen iz repozitorija ili Port koji ste postavili za servis iz gotove slike.
- Do ove adrese mogu doći samo servisi iste aplikacije. Ne otvara se s interneta ni iz drugih aplikacija.
- Adresa koristi
http://. Veza ostaje unutar aplikacije, pa nema certifikata za postavljanje.
Varijable s adresama
Adrese ne morate kopirati u kod. Svaki servis s kodom u aplikaciji — web servisi, pozadinski procesi i zakazani zadaci — dobiva varijablu s internom adresom svakog drugog web servisa aplikacije:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME je naziv servisa velikim slovima, s crticama pretvorenima u _:
| Servis | Varijabla |
|---|---|
api | RIVERVO_API_URL=http://api:8080 |
admin-api | RIVERVO_ADMIN_API_URL=http://admin-api:8080 |
web | RIVERVO_WEB_URL=http://web:8080 |
search (iz gotove slike, port 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- Servis ne dobiva varijablu za sebe.
- Baze podataka i Valkey zadržavaju vlastiti
RIVERVO_<NAME>_URLs adresom za povezivanje. Nazivi servisa jedinstveni su unutar aplikacije, pa se nazivi nikad ne preklapaju. - Varijable su navedene na kartici Varijable među varijablama Postavljeno automatski. Kao i kod svake automatske varijable, vaša vlastita (ili dijeljena) varijabla istog naziva zauzima njezino mjesto — pogledajte Varijable okruženja.
- Varijable stižu do servisa njegovim sljedećim deployem. Kada dodate novi web servis ili ga preimenujete, ostali servisi dobivaju novu ili promijenjenu varijablu svojim sljedećim deployem. Ponovno ih objavite kako bi je preuzeli, na primjer s
rivervo deploy <app> --no-build— to ponovno pokreće trenutačnu verziju s novim varijablama, bez nove izgradnje.
Servisi samo za interni pristup
Web servis koji pozivaju samo drugi servisi aplikacije — API iza vaše stranice, administracijski backend, tražilica — ne mora biti na internetu. Postavite ga na Samo interno:
| Javna adresa | Samo interno | |
|---|---|---|
Adresa na internetu https://<name>.rivervo.app | da | ne |
| Vaše vlastite domene | da | ne |
| Pregledi grana | da | ne |
| Interna adresa za ostale servise | da | da |
| Više instanci i automatsko skaliranje, zapisi, nadzor, provjere ispravnosti | da | da |
Servis samo za interni pristup radi kao svaki drugi servis; do njega mogu doći samo ostali servisi iste aplikacije.
Odabir pri izradi servisa
Kada izrađujete web servis — uključujući prvi servis nove aplikacije, iz repozitorija, predloška ili gotove slike — odaberite Javna adresa ili Samo interno. Ništa nije unaprijed odabrano, pa je izbor uvijek vaš. Pozadinski procesi, zakazani zadaci i baze podataka nikad nemaju javnu adresu, pa za njih nema izbora.
Servisi izrađeni prije uvođenja ovog izbora zadržavaju javnu adresu.
Kasnija promjena
Servis → Postavke → Javna adresa: prebacite prekidač i potvrdite. Promijeniti to može samo Administrator aplikacije ili vlasnik računa. Ništa se ne pokreće ponovno.
- Prebacivanje na samo interno odbija se dok servis ima povezane domene — najprije ih uklonite na njegovoj kartici Domene. I preglede treba najprije isključiti.
- Ponovno uključivanje javne adrese daje servisu istu adresu
https://<name>.rivervo.app. Certifikat može potrajati oko minutu. - Dodavanje domene servisu samo za interni pristup odbija se — najprije uključite njegovu javnu adresu.
Kartica Terminal u servisu samo za interni pristup radi jednako kao u svakom drugom.
Asinkrona komunikacija
Gornji pozivi čekaju odgovor. Kada servis treba predati posao i nastaviti dalje — pozadinski poslovi, događaji na koje reagira više servisa — umjesto toga šaljite poruke kroz red ili message broker: Valkey, NATS ili RabbitMQ. Pogledajte Događaji i redovi.
Više instanci
Kada servis koji pozivate radi na više instanci, njegov interni naziv vodi do svih pokrenutih instanci, a veze se raspoređuju među njima.
Klijent koji drži otvorene veze i ponovno ih koristi (keep-alive skup veza) može slati zahtjeve istoj instanci; nove veze ponovno se raspoređuju. To je normalno i ne treba nikakvo postavljanje.
Vremena čekanja i ponovni pokušaji
Tijekom deploya ili kada automatsko skaliranje zaustavi instancu, zahtjev u tijeku može ne uspjeti. Dvije navike čine pozive među servisima pouzdanima:
- Kratko vrijeme čekanja — nekoliko sekundi, kako poziv nikad ne bi visio dok se instanca kojoj je upućen zaustavlja.
- Jedan ili dva ponovna pokušaja s kratkom pauzom, za zahtjeve koje je sigurno ponoviti — čitanje podataka s
GET. Ne ponavljajte zahtjeve koji mijenjaju podatke (plaćanja, narudžbe), osim ako vaš API može razlikovati ponovljeni zahtjev od novoga.
Primjer: Node.js
const api = process.env.RIVERVO_API_URL
async function getWithRetry(url, attempts = 3) {
for (let i = 1; ; i++) {
try {
const res = await fetch(url, { signal: AbortSignal.timeout(5000) })
if (res.status < 500 || i === attempts) return res
} catch (err) {
if (i === attempts) throw err
}
await new Promise((resolve) => setTimeout(resolve, 200 * i))
}
}
const res = await getWithRetry(`${api}/orders`)
const orders = await res.json()Primjer: Laravel
Stavite adresu u config/services.php:
'api' => [
'url' => env('RIVERVO_API_URL'),
],Zatim je čitajte s config(). U produkciji je konfiguracija spremljena u predmemoriju, a env() pozvan izvan konfiguracijskih datoteka ne vraća ništa:
use Illuminate\Support\Facades\Http;
$orders = Http::timeout(5)
->retry(2, 200)
->get(config('services.api.url').'/orders')
->json();timeout(5) čeka najviše 5 sekundi; retry(2, 200) radi do 2 pokušaja s 200 ms između njih.
Primjer: Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()S ponovnim pokušajima za GET:
import os
import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry
API = os.environ["RIVERVO_API_URL"]
session = requests.Session()
retry = Retry(total=2, backoff_factor=0.2, allowed_methods=["GET"], status_forcelist=[502, 503, 504])
session.mount("http://", HTTPAdapter(max_retries=retry))
orders = session.get(f"{API}/orders", timeout=5).json()Neuspjeli GET — pogreška veze ili odgovor 502, 503 ili 504 — ponavlja se do 2 puta, s kratkom pauzom koja se svaki put produljuje.
Iz naredbenog retka i Rivervo MCP-a
rivervo appsi detalji servisa prikazuju internu adresu svakog web servisa i ima li javnu adresu.rivervo services set-public <service> on|offuključuje ili isključuje javnu adresu. Potrebni su uloga Administrator i token s Punim pristupom.- U Rivervo MCP-u isti je prekidač alat
set_public_address.
Pogledajte Alati za developere za tokene i naredbeni redak.