Komunikace mezi službami: interní adresy a služby pouze interní.
Jak se služby jedné aplikace navzájem spojí přes interní adresu, proměnné RIVERVO_<NAME>_URL, služby bez veřejné adresy, více instancí a timeouty a opakování s příklady pro Node.js, Laravel a Python.
Služby jedné aplikace spolu komunikují přímo, bez cesty přes internet. Web může volat vlastní API, worker může volat interní službu — a tento provoz je zdarma: do provozu se nezapočítává.
Příklady níže používají dvě webové služby: web, kterou otevírají návštěvníci, s Veřejnou adresou, a api, kterou volá jen web a ostatní služby, nastavenou jako Pouze interní.
Interní adresa
Každá webová služba — s veřejnou adresou i pouze interní — má Interní adresu ve tvaru http://<service-name>:<port>, například http://api:8080. Zobrazuje se na stránce služby a v Přehledu aplikace, s tlačítkem pro zkopírování a nápovědou „Ostatní služby této aplikace se k ní dostanou tady — bez internetu, bez poplatků za provoz.“
- Port je 8080 u služby sestavené z repozitáře, nebo Port, který jste nastavili u služby z hotového image.
- K této adrese se dostanou jen služby téže aplikace. Z internetu ani z jiných aplikací se neotevře.
- Adresa používá
http://. Spojení zůstává uvnitř aplikace, takže není potřeba nastavovat certifikát.
Proměnné s adresami
Adresy nemusíte kopírovat do kódu. Každá kódová služba aplikace — webové služby, workery na pozadí i plánované úlohy — dostane proměnnou s interní adresou každé další webové služby aplikace:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME je název služby velkými písmeny, pomlčky se mění na _:
| Služba | Proměnná |
|---|---|
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 (z hotového image, port 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- Služba nedostane proměnnou sama pro sebe.
- Databáze a Valkey mají vlastní
RIVERVO_<NAME>_URLs adresou pro připojení. Názvy služeb jsou v rámci aplikace jedinečné, takže se názvy nikdy nepřekrývají. - Proměnné najdete na kartě Proměnné mezi proměnnými Nastaveno automaticky. Jako u každé automatické proměnné ji nahradí vlastní (nebo sdílená) proměnná se stejným názvem — viz Proměnné prostředí.
- Proměnné se do služby dostanou s jejím příštím nasazením. Když přidáte novou webovou službu nebo nějakou přejmenujete, ostatní služby dostanou novou nebo změněnou proměnnou při svém příštím nasazení. Nasaďte je znovu, aby ji načetly, například příkazem
rivervo deploy <app> --no-build— znovu spustí běžící verzi s novými proměnnými, bez nového sestavení.
Služby pouze interní
Webová služba, kterou volají jen ostatní služby aplikace — API za vaším webem, administrační backend, vyhledávač —, nemusí být v internetu. Nastavte ji jako Pouze interní:
| Veřejná adresa | Pouze interní | |
|---|---|---|
Adresa v internetu https://<name>.rivervo.app | ano | ne |
| Vlastní domény | ano | ne |
| Náhledy větví | ano | ne |
| Interní adresa pro ostatní služby | ano | ano |
| Více instancí a automatické škálování, logy, monitoring, kontroly stavu | ano | ano |
Služba pouze interní běží jako kterákoli jiná služba; dostanou se k ní jen ostatní služby téže aplikace.
Volba při vytváření služby
Když vytváříte webovou službu — včetně první služby nové aplikace, z repozitáře, šablony nebo hotového image —, zvolte Veřejná adresa nebo Pouze interní. Předem není vybráno nic, takže volba je vždy na vás. Workery na pozadí, plánované úlohy a databáze veřejnou adresu nikdy nemají, takže u nich se nic nevolí.
Služby vytvořené dřív, než tato volba existovala, si veřejnou adresu ponechávají.
Pozdější přepnutí
Služba → Nastavení → Veřejná adresa: přepněte přepínač a potvrďte. Změnit to může jen Administrátor aplikace nebo vlastník účtu. Nic se nerestartuje.
- Přepnutí na pouze interní se odmítne, dokud má služba připojené domény — nejdřív je odeberte na její kartě Domény. Vypnout je předtím potřeba i náhledy.
- Opětovné zapnutí veřejné adresy dá službě stejnou adresu
https://<name>.rivervo.app. Certifikát může trvat asi minutu. - Přidání domény ke službě pouze interní se odmítne — nejdřív zapněte její veřejnou adresu.
Karta Terminál funguje ve službě pouze interní stejně jako v kterékoli jiné.
Asynchronní komunikace
Výše popsaná volání čekají na odpověď. Když má služba práci předat a pokračovat dál — úlohy na pozadí, události, na které reaguje několik služeb —, posílejte místo toho zprávy přes frontu nebo message broker: Valkey, NATS nebo RabbitMQ. Viz Události a fronty.
Více instancí
Když volaná služba běží ve více instancích, její interní název vede na všechny její běžící instance a spojení se mezi ně rozdělují.
Klient, který spojení drží otevřená a znovu je používá (pool keep-alive spojení), může posílat požadavky stále na stejnou instanci; nová spojení se rozdělí znovu. To je normální a nevyžaduje žádné nastavení.
Timeouty a opakování
Během nasazení, nebo když automatické škálování zastaví instanci, může probíhající požadavek selhat. Volání mezi službami udělají spolehlivými dva návyky:
- Krátký timeout — pár sekund, aby volání nikdy neviselo, zatímco se instance, na kterou šlo, zastavuje.
- Jedno nebo dvě opakování s krátkou pauzou u požadavků, které je bezpečné zopakovat — čtení dat přes
GET. Neopakujte požadavky, které mění data (platby, objednávky), pokud vaše API neumí opakovaný požadavek odlišit od nového.
Příklad: 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říklad: Laravel
Adresu uložte do config/services.php:
'api' => [
'url' => env('RIVERVO_API_URL'),
],Pak ji čtěte přes config(). V produkci je konfigurace uložená v cache a env() volané mimo konfigurační soubory nevrací nic:
use Illuminate\Support\Facades\Http;
$orders = Http::timeout(5)
->retry(2, 200)
->get(config('services.api.url').'/orders')
->json();timeout(5) čeká nejvýše 5 sekund; retry(2, 200) udělá až 2 pokusy s odstupem 200 ms.
Příklad: Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()S opakováním u 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()Neúspěšný GET — chyba spojení nebo odpověď 502, 503 či 504 — se zopakuje až dvakrát, s krátkou pauzou, která se pokaždé prodlužuje.
Z příkazové řádky a z Rivervo MCP
rivervo appsa podrobnosti služby ukazují interní adresu každé webové služby a to, zda má veřejnou adresu.rivervo services set-public <service> on|offpřepíná veřejnou adresu. Vyžaduje roli Administrátor a token s úrovní Plný přístup.- V Rivervo MCP slouží ke stejnému přepnutí nástroj
set_public_address.
Tokeny a příkazovou řádku popisuje článek Nástroje pro vývojáře.