Kezdés

Szolgáltatások közötti kommunikáció: belső címek és csak belső szolgáltatások.

Hogyan érik el egymást egy alkalmazás szolgáltatásai a belső címen, a RIVERVO_<NAME>_URL változók, nyilvános cím nélküli szolgáltatások, több példány, valamint időkorlátok és újrapróbálkozások példákkal Node.js-hez, Laravelhez és Pythonhoz.

6 PERC OLVASÁS

Egy alkalmazás szolgáltatásai közvetlenül, az internet megkerülésével kommunikálnak egymással. Egy oldal meghívhatja a saját API-ját, egy háttérfolyamat egy belső szolgáltatást – és ez a forgalom ingyenes: nem számít bele a forgalomba.

Az alábbi példák két webszolgáltatást használnak: a web szolgáltatást, amelyet a látogatók megnyitnak, Nyilvános címmel, és az api szolgáltatást, amelyet csak a web és a többi szolgáltatás hív, Csak belső beállítással.

A belső cím

Minden webszolgáltatásnak – nyilvános címmel vagy csak belső eléréssel – van egy http://<service-name>:<port> formátumú Belső címe, például http://api:8080. Ez a szolgáltatás oldalán és az alkalmazás Áttekintés részén látható, másolás gombbal és ezzel a tippel: „Az alkalmazás többi szolgáltatása itt éri el – internet és forgalmi díj nélkül.”

  • A port 8080 a tárolóból épített szolgáltatásnál, illetve a megadott Port a kész image-ből indított szolgáltatásnál.
  • Ezt a címet csak ugyanannak az alkalmazásnak a szolgáltatásai érik el. Az internetről és más alkalmazásokból nem nyílik meg.
  • A cím http:// protokollt használ. A kapcsolat az alkalmazáson belül marad, így nincs beállítandó tanúsítvány.

Változók a címekkel

A címeket nem kell bemásolnod a kódodba. Az alkalmazás minden kódalapú szolgáltatása – webszolgáltatások, háttérfolyamatok és ütemezett feladatok – kap egy változót az alkalmazás minden másik webszolgáltatásának belső címével:

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

A NAME a szolgáltatás neve nagybetűkkel, a kötőjelek helyén _ jellel:

SzolgáltatásVáltozó
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_WEB_URL=http://web:8080
search (kész image-ből, 7700-as port)RIVERVO_SEARCH_URL=http://search:7700
  • Egy szolgáltatás nem kap változót saját magáról.
  • Az adatbázisok és a Valkey megtartják a saját RIVERVO_<NAME>_URL változójukat a kapcsolati címmel. A szolgáltatásnevek egy alkalmazáson belül egyediek, így a nevek soha nem ütköznek.
  • A változók a Változók fülön, az Automatikusan beállított változók között láthatók. Mint minden automatikus változónál, egy azonos nevű saját (vagy megosztott) változó lép a helyére – lásd: Környezeti változók.
  • A változók a következő telepítéssel jutnak el egy szolgáltatáshoz. Ha új webszolgáltatást adsz hozzá vagy átnevezel egyet, a többi szolgáltatás a következő telepítésekor kapja meg az új vagy módosított változót. Telepítsd újra őket, hogy átvegyék, például a rivervo deploy <app> --no-build paranccsal – ez új build nélkül, az új változókkal indítja újra a futó verziót.

Csak belső szolgáltatások

Annak a webszolgáltatásnak, amelyet csak az alkalmazás többi szolgáltatása hív – egy oldalad mögötti API, egy admin backend, egy keresőmotor –, nem kell az interneten lennie. Állítsd Csak belső értékre:

Nyilvános címCsak belső
Cím az interneten https://<name>.rivervo.appigennem
Saját domainekigennem
Ágelőnézetekigennem
Belső cím a többi szolgáltatás számáraigenigen
Több példány és automatikus skálázás, naplók, monitorozás, állapotellenőrzésekigenigen

A csak belső szolgáltatás ugyanúgy fut, mint bármely más szolgáltatás; csak ugyanannak az alkalmazásnak a többi szolgáltatása éri el.

Választás a szolgáltatás létrehozásakor

Amikor webszolgáltatást hozol létre – egy új alkalmazás első szolgáltatását is, tárolóból, sablonból vagy kész image-ből –, válaszd a Nyilvános cím vagy a Csak belső lehetőséget. Előre semmi nincs kiválasztva, így a döntés mindig a tiéd. A háttérfolyamatoknak, az ütemezett feladatoknak és az adatbázisoknak soha nincs nyilvános címük, így náluk nincs választás.

Az e lehetőség bevezetése előtt létrehozott szolgáltatások megtartják a nyilvános címüket.

Későbbi váltás

A szolgáltatás → Beállítások → Nyilvános cím: kapcsold át a kapcsolót, és erősítsd meg. Csak az alkalmazás Adminisztrátora vagy a fiók tulajdonosa módosíthatja. Semmi nem indul újra.

  • A csak belső elérésre váltást elutasítjuk, amíg a szolgáltatáshoz domainek vannak csatlakoztatva – előbb távolítsd el őket a Domainek fülén. Az előnézeteket is előbb ki kell kapcsolni.
  • A nyilvános cím visszakapcsolásakor a szolgáltatás ugyanazt a https://<name>.rivervo.app címet kapja. A tanúsítvány nagyjából egy percig tarthat.
  • Domain hozzáadását egy csak belső szolgáltatáshoz elutasítjuk – előbb kapcsold be a nyilvános címét.

A Terminál fül egy csak belső szolgáltatásban ugyanúgy működik, mint bármely másikban.

Aszinkron kommunikáció

A fenti hívások választ várnak. Ha egy szolgáltatásnak át kell adnia egy munkát, és tovább kell lépnie – háttérfeladatok, több szolgáltatás által kezelt események –, küldj inkább üzeneteket egy soron vagy üzenetközvetítőn keresztül: Valkey, NATS vagy RabbitMQ. Lásd: Események és sorok.

Több példány

Ha a hívott szolgáltatás több példányban fut, a belső neve az összes futó példányához vezet, és a kapcsolatok megoszlanak közöttük.

Az a kliens, amely nyitva tartja és újrahasznosítja a kapcsolatait (keep-alive kapcsolatkészlet), a kéréseit továbbra is ugyanahhoz a példányhoz küldheti; az új kapcsolatok ismét megoszlanak. Ez normális, és nem igényel beállítást.

Időkorlátok és újrapróbálkozások

Telepítés közben, vagy amikor az automatikus skálázás leállít egy példányt, egy folyamatban lévő kérés meghiúsulhat. Két szokás teszi megbízhatóvá a szolgáltatások közötti hívásokat:

  • Rövid időkorlát – néhány másodperc, hogy egy hívás soha ne akadjon el, miközben a példány, amelyhez került, éppen leáll.
  • Egy-két újrapróbálkozás rövid szünettel, a biztonságosan megismételhető kéréseknél – adatok olvasása GET kéréssel. Az adatokat módosító kéréseket (fizetések, rendelések) ne ismételd meg, hacsak az API-d meg nem tudja különböztetni az ismételt kérést az újtól.

Példa: 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()

Példa: Laravel

Tedd a címet a config/services.php fájlba:

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

Ezután a config() segítségével olvasd. Éles környezetben a konfiguráció gyorsítótárazva van, és a konfigurációs fájlokon kívül hívott env() semmit nem ad vissza:

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

A timeout(5) legfeljebb 5 másodpercig vár; a retry(2, 200) legfeljebb 2 próbálkozást tesz, köztük 200 ms szünettel.

Példa: Python

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

Újrapróbálkozással GET kérésekhez:

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

A sikertelen GET kérést – kapcsolati hiba vagy 502-es, 503-as, 504-es válasz esetén – legfeljebb 2-szer megismételjük, egyre hosszabb rövid szünettel.

Parancssorból és a Rivervo MCP-ből

  • A rivervo apps és a szolgáltatás részletei mutatják minden webszolgáltatás belső címét, és azt, hogy van-e nyilvános címe.
  • A rivervo services set-public <service> on|off átkapcsolja a nyilvános címet. Ehhez Adminisztrátor szerep és Teljes hozzáférés szintű token kell.
  • A Rivervo MCP-ben ugyanez a kapcsoló a set_public_address eszköz.

A tokenekről és a parancssorról lásd: Fejlesztői eszközök.

Elakadtál?

Írj nekünk chaten — az AI azonnal válaszol, és ha kell, egy mérnök is bekapcsolódik, a nap bármely szakában.

Ügyfélszolgálat