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.
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ás | Változó |
|---|---|
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 (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>_URLvá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-buildparanccsal – 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ím | Csak belső | |
|---|---|---|
Cím az interneten https://<name>.rivervo.app | igen | nem |
| Saját domainek | igen | nem |
| Ágelőnézetek | igen | nem |
| Belső cím a többi szolgáltatás számára | igen | igen |
| Több példány és automatikus skálázás, naplók, monitorozás, állapotellenőrzések | igen | igen |
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.appcí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
GETké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_addresseszköz.
A tokenekről és a parancssorról lásd: Fejlesztői eszközök.