Komunikacija između servisa: interne adrese i samo interni servisi.
Kako servisi jedne aplikacije pristupaju jedni drugima preko interne adrese, promenljive RIVERVO_<NAME>_URL, servisi bez javne adrese, više instanci i vremenski limiti i ponovni pokušaji sa primerima za Node.js, Laravel i Python.
Servisi jedne aplikacije komuniciraju direktno, bez prolaska kroz internet. Sajt može da poziva sopstveni API, worker može da poziva interni servis — a ovaj saobraćaj je besplatan: ne računa se kao saobraćaj.
Primeri u nastavku koriste dva veb servisa: web, sajt koji posetioci otvaraju, sa Javnom adresom, i api, koji pozivaju samo web i ostali servisi, podešen kao Samo interni.
Interna adresa
Svaki veb servis — sa javnom adresom ili samo interni — ima Internu adresu u obliku http://<service-name>:<port>, na primer http://api:8080. Prikazana je na stranici servisa i u Pregledu aplikacije, sa dugmetom za kopiranje i napomenom „Ostali servisi ove aplikacije pristupaju mu ovde — bez interneta i bez naplate saobraćaja.“
- Port je 8080 za servis izgrađen iz repozitorijuma, ili Port koji ste podesili za servis iz gotove slike.
- Ovoj adresi mogu pristupiti samo servisi iste aplikacije. Ne otvara se sa interneta niti iz drugih aplikacija.
- Adresa koristi
http://. Veza ostaje unutar aplikacije, pa nema sertifikata koji treba podesiti.
Promenljive sa adresama
Adrese ne morate kopirati u kod. Svaki servis sa kodom u aplikaciji — veb servisi, pozadinski procesi i zakazani zadaci — dobija promenljivu sa internom adresom svakog drugog veb servisa aplikacije:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME je ime servisa velikim slovima, sa crticama zamenjenim sa _:
| Servis | Promenljiva |
|---|---|
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 dobija promenljivu za samog sebe.
- Baze podataka i Valkey zadržavaju sopstvenu
RIVERVO_<NAME>_URLsa adresom za povezivanje. Imena servisa su jedinstvena u okviru aplikacije, pa se imena nikada ne preklapaju. - Promenljive su navedene na kartici Promenljive među promenljivama Podešeno automatski. Kao i kod svake automatske promenljive, vaša sopstvena (ili deljena) promenljiva istog imena zauzima njeno mesto — pogledajte Promenljive okruženja.
- Promenljive stižu do servisa pri njegovom sledećem deployu. Kada dodate novi veb servis ili preimenujete postojeći, ostali servisi dobijaju novu ili izmenjenu promenljivu pri svom sledećem deployu. Ponovo uradite njihov deploy da bi je preuzeli, na primer sa
rivervo deploy <app> --no-build— to ponovo pokreće trenutnu verziju sa novim promenljivama, bez nove gradnje.
Samo interni servisi
Veb servis koji pozivaju samo ostali servisi aplikacije — API iza vašeg sajta, administratorski backend, pretraživač — ne mora biti na internetu. Podesite ga kao Samo interni:
| Javna adresa | Samo interni | |
|---|---|---|
Adresa na internetu https://<name>.rivervo.app | da | ne |
| Vaši domeni | da | ne |
| Pregledi grana | da | ne |
| Interna adresa za ostale servise | da | da |
| Više instanci i automatsko skaliranje, logovi, praćenje, provere rada | da | da |
Samo interni servis radi kao svaki drugi servis; pristupati mu mogu samo ostali servisi iste aplikacije.
Izbor pri pravljenju servisa
Kada pravite veb servis — uključujući prvi servis nove aplikacije, iz repozitorijuma, šablona ili gotove slike — izaberite Javna adresa ili Samo interni. Ništa nije unapred izabrano, pa je izbor uvek vaš. Pozadinski procesi, zakazani zadaci i baze podataka nikada nemaju javnu adresu, pa za njih nema izbora.
Servisi napravljeni pre nego što je ovaj izbor postojao zadržavaju javnu adresu.
Kasnija promena
Servis → Podešavanja → Javna adresa: prebacite prekidač i potvrdite. Samo Administrator aplikacije ili vlasnik naloga mogu ovo da promene. Ništa se ne restartuje.
- Prelazak na samo interni se odbija dok servis ima povezane domene — prvo ih uklonite na njegovoj kartici Domeni. Takođe prvo morate isključiti preglede.
- Ponovno uključivanje javne adrese vraća servisu istu adresu
https://<name>.rivervo.app. Sertifikatu može biti potrebno oko minut. - Dodavanje domena samo internom servisu se odbija — prvo uključite njegovu javnu adresu.
Kartica Terminal u samo internom servisu radi isto kao u bilo kom drugom.
Asinhrona komunikacija
Gore opisani pozivi čekaju odgovor. Kada servis treba da preda posao i nastavi dalje — pozadinski poslovi, događaji na koje reaguje više servisa — šaljite poruke kroz red ili broker poruka: Valkey, NATS ili RabbitMQ. Pogledajte Događaji i redovi.
Više instanci
Kada servis koji pozivate radi sa više instanci, njegovo interno ime vodi do svih njegovih pokrenutih instanci, a veze se raspoređuju među njima.
Klijent koji drži veze otvorenim i ponovo ih koristi (keep-alive pul veza) može nastaviti da šalje zahteve istoj instanci; nove veze se ponovo raspoređuju. To je normalno i ne zahteva podešavanje.
Vremenski limiti i ponovni pokušaji
Tokom deploya, ili kada automatsko skaliranje zaustavi instancu, zahtev koji je u toku može da ne uspe. Dve navike čine pozive između servisa pouzdanim:
- Kratak vremenski limit — nekoliko sekundi, kako poziv nikada ne bi visio dok se instanca do koje je stigao zaustavlja.
- Jedan ili dva ponovna pokušaja sa kratkom pauzom, za zahteve koje je bezbedno ponoviti — čitanje podataka sa
GET. Ne ponavljajte zahteve koji menjaju podatke (plaćanja, porudžbine) osim ako vaš API može da razlikuje ponovljeni zahtev od novog.
Primer: 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()Primer: Laravel
Stavite adresu u config/services.php:
'api' => [
'url' => env('RIVERVO_API_URL'),
],Zatim je čitajte pomoću config(). U produkciji je konfiguracija keširana, a env() pozvan van konfiguracionih fajlova 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) pravi do 2 pokušaja sa 200 ms između njih.
Primer: Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()Sa 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()Neuspeo GET — greška veze ili odgovor 502, 503 ili 504 — ponavlja se do 2 puta, sa kratkom pauzom koja se svaki put produžava.
Iz komandne linije i Rivervo MCP
rivervo appsi detalji servisa prikazuju internu adresu svakog veb servisa i da li ima javnu adresu.rivervo services set-public <service> on|offuključuje ili isključuje javnu adresu. Potrebni su uloga Administrator i token sa Punim pristupom.- U Rivervo MCP isti prekidač je alat
set_public_address.
Pogledajte Alati za programere za tokene i komandnu liniju.