Započnite

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.

5 MIN ČITANJA

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 _:

ServisPromenljiva
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_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>_URL sa 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 adresaSamo interni
Adresa na internetu https://<name>.rivervo.appdane
Vaši domenidane
Pregledi granadane
Interna adresa za ostale servisedada
Više instanci i automatsko skaliranje, logovi, praćenje, provere radadada

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 apps i detalji servisa prikazuju internu adresu svakog veb servisa i da li ima javnu adresu.
  • rivervo services set-public <service> on|off uključ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.

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