Începe acum

Comunicarea între servicii: adrese interne și servicii doar interne.

Cum ajung serviciile unei aplicații unul la altul prin adresa internă, variabilele RIVERVO_<NAME>_URL, serviciile fără adresă publică, instanțele multiple, plus timeouturi și reîncercări cu exemple pentru Node.js, Laravel și Python.

6 MIN DE CITIT

Serviciile unei aplicații comunică direct între ele, fără să treacă prin internet. Un site își poate apela propriul API, un worker poate apela un serviciu intern — iar acest trafic este gratuit: nu se socotește trafic.

Exemplele de mai jos folosesc două servicii web: web, site-ul pe care îl deschid vizitatorii, cu Adresă publică, și api, pe care îl apelează doar web și celelalte servicii, setat pe Doar intern.

Adresa internă

Fiecare serviciu web — cu adresă publică sau doar intern — are o Adresă internă de forma http://<service-name>:<port>, de exemplu http://api:8080. Apare pe pagina serviciului și în Prezentare generală a aplicației, cu un buton de copiere și indicația «Celelalte servicii ale acestei aplicații ajung la el aici — fără internet, fără costuri de trafic.»

  • Portul este 8080 pentru un serviciu construit dintr-un repository sau Portul setat de tine pentru un serviciu dintr-o imagine gata făcută.
  • Doar serviciile aceleiași aplicații pot accesa această adresă. Nu se deschide din internet și nici din alte aplicații.
  • Adresa folosește http://. Conexiunea rămâne în interiorul aplicației, așa că nu ai de configurat niciun certificat.

Variabile cu adresele

Nu trebuie să copiezi adresele în cod. Fiecare serviciu cu cod al aplicației — servicii web, workeri de fundal și sarcini programate — primește o variabilă cu adresa internă a fiecărui alt serviciu web al aplicației:

RIVERVO_<NAME>_URL=http://<name>:<port>

NAME este numele serviciului cu majuscule, cu cratimele înlocuite de _:

ServiciuVariabilă
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_WEB_URL=http://web:8080
search (dintr-o imagine gata făcută, portul 7700)RIVERVO_SEARCH_URL=http://search:7700
  • Un serviciu nu primește variabilă pentru el însuși.
  • Bazele de date și Valkey își păstrează propriul RIVERVO_<NAME>_URL cu adresa de conexiune. Numele serviciilor sunt unice în cadrul unei aplicații, așa că numele nu se suprapun niciodată.
  • Variabilele apar în fila Variabile, printre cele Setate automat. Ca la orice variabilă automată, o variabilă proprie (sau una partajată) cu același nume îi ia locul — vezi Variabile de mediu.
  • Variabilele ajung la un serviciu la următoarea lui publicare. Când adaugi un serviciu web nou sau redenumești unul, celelalte servicii primesc variabila nouă sau modificată la următoarea lor publicare. Publică-le din nou ca s-o preia, de exemplu cu rivervo deploy <app> --no-build — pornește din nou versiunea care rulează, cu variabilele noi, fără un build nou.

Servicii doar interne

Un serviciu web pe care îl apelează doar celelalte servicii ale aplicației — un API din spatele site-ului, un backend de administrare, un motor de căutare — nu are nevoie să fie pe internet. Setează-l pe Doar intern:

Adresă publicăDoar intern
Adresă pe internet https://<name>.rivervo.appdanu
Domeniile taledanu
Previzualizări de branchdanu
Adresă internă pentru celelalte serviciidada
Instanțe multiple și scalare automată, loguri, monitorizare, verificări de funcționaredada

Un serviciu doar intern rulează ca oricare altul; doar celelalte servicii ale aceleiași aplicații pot ajunge la el.

Alegerea la crearea unui serviciu

Când creezi un serviciu web — inclusiv primul serviciu al unei aplicații noi, dintr-un repository, un șablon sau o imagine gata făcută — alege Adresă publică sau Doar intern. Nimic nu este bifat dinainte, așa că alegerea îți aparține mereu. Workerii de fundal, sarcinile programate și bazele de date nu au niciodată adresă publică, deci pentru ele nu ai de ales.

Serviciile create înainte să existe această opțiune își păstrează adresa publică.

Schimbarea ulterioară

Serviciul → Setări → Adresă publică: comută butonul și confirmă. Doar un Administrator al aplicației sau proprietarul contului o poate schimba. Nu repornește nimic.

  • Trecerea pe doar intern este refuzată cât timp serviciul are domenii conectate — elimină-le mai întâi din fila lui Domenii. Și previzualizările trebuie dezactivate înainte.
  • Reactivarea adresei publice îi redă serviciului aceeași adresă https://<name>.rivervo.app. Certificatul poate dura cam un minut.
  • Adăugarea unui domeniu la un serviciu doar intern este refuzată — activează-i mai întâi adresa publică.

Fila Terminal funcționează într-un serviciu doar intern la fel ca în oricare altul.

Comunicare asincronă

Apelurile de mai sus așteaptă un răspuns. Când un serviciu trebuie să predea o sarcină și să meargă mai departe — joburi în fundal, evenimente la care reacționează mai multe servicii — trimite în schimb mesaje printr-o coadă sau un broker de mesaje: Valkey, NATS sau RabbitMQ. Vezi Evenimente și cozi.

Instanțe multiple

Când serviciul pe care îl apelezi rulează mai multe instanțe, numele lui intern duce la toate instanțele care rulează, iar conexiunile sunt împărțite între ele.

Un client care își ține conexiunile deschise și le refolosește (un pool de conexiuni keep-alive) poate trimite în continuare cererile la aceeași instanță; conexiunile noi sunt împărțite din nou. E normal și nu cere nicio configurare.

Timeouturi și reîncercări

În timpul unei publicări sau când scalarea automată oprește o instanță, o cerere aflată în curs poate eșua. Două obiceiuri fac apelurile dintre servicii sigure:

  • Un timeout scurt — câteva secunde, ca un apel să nu rămână blocat cât timp instanța la care a ajuns se oprește.
  • Una sau două reîncercări cu o pauză scurtă, pentru cererile care pot fi repetate fără risc — citirea datelor cu GET. Nu repeta cererile care modifică date (plăți, comenzi), decât dacă API-ul tău poate deosebi o cerere repetată de una nouă.

Exemplu: 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()

Exemplu: Laravel

Pune adresa în config/services.php:

'api' => [
    'url' => env('RIVERVO_API_URL'),
],

Apoi citește-o cu config(). În producție configurația este pusă în cache, iar env() apelat în afara fișierelor de configurare nu întoarce nimic:

use Illuminate\Support\Facades\Http;
 
$orders = Http::timeout(5)
    ->retry(2, 200)
    ->get(config('services.api.url').'/orders')
    ->json();

timeout(5) așteaptă cel mult 5 secunde; retry(2, 200) face până la 2 încercări, cu 200 ms între ele.

Exemplu: Python

import os
import requests
 
API = os.environ["RIVERVO_API_URL"]
 
orders = requests.get(f"{API}/orders", timeout=5).json()

Cu reîncercări pentru 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()

Un GET eșuat — o eroare de conexiune sau un răspuns 502, 503 ori 504 — se repetă de cel mult 2 ori, cu o pauză scurtă care crește de fiecare dată.

Din linia de comandă și din Rivervo MCP

  • rivervo apps și detaliile serviciului arată adresa internă a fiecărui serviciu web și dacă are adresă publică.
  • rivervo services set-public <service> on|off comută adresa publică. Are nevoie de rolul Administrator și de un token cu Acces complet.
  • În Rivervo MCP, aceeași comutare este instrumentul set_public_address.

Vezi Instrumente pentru dezvoltatori pentru tokenuri și linia de comandă.

Încă ai întrebări?

Scrie-ne în chat — asistentul AI răspunde imediat, iar un inginer intervine când e nevoie, la orice oră.

Contactează suportul