Komunikácia medzi službami: interné adresy a služby len interné.
Ako sa služby jednej aplikácie navzájom dosiahnu cez internú adresu, premenné RIVERVO_<NAME>_URL, služby bez verejnej adresy, viac inštancií a časové limity a opakovania s príkladmi pre Node.js, Laravel a Python.
Služby jednej aplikácie spolu komunikujú priamo, bez cesty cez internet. Web môže volať vlastné API, proces na pozadí internú službu — a tento prenos je zadarmo: nezapočítava sa.
Príklady nižšie používajú dve webové služby: web, ktorý otvárajú návštevníci, s Verejnou adresou, a api, ktoré volá len web a ostatné služby, nastavené na Len interná.
Interná adresa
Každá webová služba — s verejnou adresou aj len interná — má Internú adresu v tvare http://<service-name>:<port>, napríklad http://api:8080. Zobrazuje sa na stránke služby a v Prehľade aplikácie, s tlačidlom na kopírovanie a s nápovedou „Ostatné služby tejto aplikácie ju dosiahnu tu — bez internetu, bez poplatkov za prenos.“
- Port je 8080 pre službu zostavenú z repozitára, alebo Port, ktorý ste nastavili pre službu z hotového obrazu.
- Túto adresu dosiahnu len služby tej istej aplikácie. Neotvorí sa z internetu ani z iných aplikácií.
- Adresa používa
http://. Spojenie zostáva vnútri aplikácie, takže netreba nastavovať certifikát.
Premenné s adresami
Adresy nemusíte kopírovať do kódu. Každá kódová služba aplikácie — webové služby, procesy na pozadí a plánované úlohy — dostane premennú s internou adresou každej ďalšej webovej služby aplikácie:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME je názov služby veľkými písmenami, s pomlčkami nahradenými znakom _:
| Služba | Premenná |
|---|---|
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 obrazu, port 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- Služba nedostane premennú sama pre seba.
- Databázy a Valkey si ponechávajú vlastnú
RIVERVO_<NAME>_URLs adresou pripojenia. Názvy služieb sú v rámci aplikácie jedinečné, takže sa nikdy nezrazia. - Premenné nájdete na karte Premenné medzi premennými Nastavené automaticky. Ako pri každej automatickej premennej, vlastná premenná (alebo zdieľaná premenná) s rovnakým názvom nastúpi na jej miesto — pozrite Premenné prostredia.
- Premenné sa do služby dostanú pri jej najbližšom nasadení. Keď pridáte novú webovú službu alebo niektorú premenujete, ostatné služby dostanú novú či zmenenú premennú pri svojom najbližšom nasadení. Nasaďte ich znova, aby si ju načítali, napríklad príkazom
rivervo deploy <app> --no-build— spustí bežiacu verziu znova s novými premennými, bez nového zostavenia.
Služby len interné
Webová služba, ktorú volajú len ostatné služby aplikácie — API za vaším webom, administračný backend, vyhľadávač —, nemusí byť na internete. Nastavte ju na Len interná:
| Verejná adresa | Len interná | |
|---|---|---|
Adresa na internete https://<name>.rivervo.app | áno | nie |
| Vlastné domény | áno | nie |
| Náhľady vetiev | áno | nie |
| Interná adresa pre ostatné služby | áno | áno |
| Viac inštancií a automatické škálovanie, logy, monitorovanie, kontroly stavu | áno | áno |
Služba len interná beží ako každá iná služba; dosiahnu ju len ostatné služby tej istej aplikácie.
Voľba pri vytváraní služby
Keď vytvárate webovú službu — vrátane prvej služby novej aplikácie, z repozitára, šablóny alebo hotového obrazu —, zvoľte Verejná adresa alebo Len interná. Nič nie je predvybrané, takže voľba je vždy na vás. Procesy na pozadí, plánované úlohy a databázy nikdy nemajú verejnú adresu, takže pri nich sa nevyberá.
Služby vytvorené predtým, ako táto voľba existovala, si ponechávajú verejnú adresu.
Neskoršia zmena
Služba → Nastavenia → Verejná adresa: prepnite prepínač a potvrďte. Zmeniť to môže len Administrátor aplikácie alebo vlastník účtu. Nič sa nereštartuje.
- Prepnutie na len internú sa odmietne, kým má služba pripojené domény — najprv ich odstráňte na jej karte Domény. Najprv treba vypnúť aj náhľady.
- Opätovné zapnutie verejnej adresy dá službe rovnakú adresu
https://<name>.rivervo.app. Certifikát môže trvať asi minútu. - Pridanie domény k službe len internej sa odmietne — najprv zapnite jej verejnú adresu.
Karta Terminál funguje v službe len internej rovnako ako v každej inej.
Asynchrónna komunikácia
Vyššie uvedené volania čakajú na odpoveď. Keď má služba prácu odovzdať a pokračovať — úlohy na pozadí, udalosti, na ktoré reaguje viac služieb —, posielajte namiesto toho správy cez frontu alebo message broker: Valkey, NATS alebo RabbitMQ. Pozrite Udalosti a fronty.
Viac inštancií
Keď volaná služba beží vo viacerých inštanciách, jej interný názov vedie ku všetkým jej bežiacim inštanciám a spojenia sa medzi ne rozdeľujú.
Klient, ktorý udržiava spojenia otvorené a znova ich používa (keep-alive pool spojení), môže posielať požiadavky stále tej istej inštancii; nové spojenia sa rozdelia znova. Je to normálne a nevyžaduje to žiadne nastavenie.
Časové limity a opakovania
Počas nasadenia alebo keď automatické škálovanie zastaví inštanciu, môže prebiehajúca požiadavka zlyhať. Dva návyky robia volania medzi službami spoľahlivými:
- Krátky časový limit — niekoľko sekúnd, aby volanie nikdy neviselo, kým sa inštancia, na ktorú išlo, zastavuje.
- Jedno alebo dve opakovania s krátkou pauzou pri požiadavkách, ktoré je bezpečné zopakovať — čítanie dát cez
GET. Neopakujte požiadavky, ktoré menia dáta (platby, objednávky), pokiaľ vaše API nevie rozlíšiť zopakovanú požiadavku od novej.
Prí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()Príklad: Laravel
Adresu vložte do config/services.php:
'api' => [
'url' => env('RIVERVO_API_URL'),
],Potom ju čítajte cez config(). V produkcii je konfigurácia v cache a env() volané mimo konfiguračných súborov nevráti nič:
use Illuminate\Support\Facades\Http;
$orders = Http::timeout(5)
->retry(2, 200)
->get(config('services.api.url').'/orders')
->json();timeout(5) čaká najviac 5 sekúnd; retry(2, 200) urobí najviac 2 pokusy s 200 ms medzi nimi.
Príklad: Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()S opakovaniami pre 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úspešný GET — chyba spojenia alebo odpoveď 502, 503 či 504 — sa zopakuje najviac 2-krát, s krátkou pauzou, ktorá sa zakaždým predĺži.
Z príkazového riadka a Rivervo MCP
rivervo appsa podrobnosti služby ukazujú internú adresu každej webovej služby a či má verejnú adresu.rivervo services set-public <service> on|offprepína verejnú adresu. Vyžaduje rolu Administrátor a token s Plným prístupom.- V Rivervo MCP je rovnaký prepínač nástroj
set_public_address.
Pozrite Nástroje pre vývojárov — tokeny a príkazový riadok.