Communicatie tussen diensten: interne adressen en diensten die alleen intern zijn.
Hoe de diensten van één applicatie elkaar bereiken via het interne adres, de variabelen RIVERVO_<NAME>_URL, diensten zonder openbaar adres, meerdere instances, en time-outs en nieuwe pogingen, met voorbeelden voor Node.js, Laravel en Python.
De diensten van één applicatie praten rechtstreeks met elkaar, zonder omweg via het internet. Een site kan zijn eigen API aanroepen, een worker kan een interne dienst aanroepen — en dat verkeer is gratis: het telt niet als verkeer.
De voorbeelden hieronder gebruiken twee webdiensten: web, de site die bezoekers openen, met een Openbaar adres, en api, die alleen door web en de andere diensten wordt aangeroepen en op Alleen intern staat.
Het interne adres
Elke webdienst — met een openbaar adres of alleen intern — heeft een Intern adres in de vorm http://<service-name>:<port>, bijvoorbeeld http://api:8080. Je ziet het op de pagina van de dienst en in het Overzicht van de applicatie, met een kopieerknop en de hint «Andere diensten van deze applicatie bereiken hem hier — zonder internet, zonder kosten voor verkeer.»
- De poort is 8080 voor een dienst die vanuit een repository is gebouwd, of de Poort die je hebt ingesteld voor een dienst vanuit een kant-en-klare image.
- Alleen de diensten van dezelfde applicatie kunnen dit adres bereiken. Vanaf het internet of vanuit andere applicaties opent het niet.
- Het adres gebruikt
http://. De verbinding blijft binnen de applicatie, dus er hoeft geen certificaat ingesteld te worden.
Variabelen met de adressen
Je hoeft de adressen niet in je code te kopiëren. Elke codedienst van de applicatie — webdiensten, achtergrondworkers en geplande taken — krijgt een variabele met het interne adres van elke andere webdienst van de applicatie:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME is de naam van de dienst in hoofdletters, met streepjes vervangen door _:
| Dienst | Variabele |
|---|---|
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 (vanuit een kant-en-klare image, poort 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- Een dienst krijgt geen variabele voor zichzelf.
- Databases en Valkey houden hun eigen
RIVERVO_<NAME>_URLmet het verbindingsadres. Dienstnamen zijn uniek binnen een applicatie, dus de namen botsen nooit. - De variabelen staan op het tabblad Variabelen bij de variabelen onder Automatisch ingesteld. Zoals bij elke automatische variabele neemt een eigen variabele (of een gedeelde variabele) met dezelfde naam de plaats ervan in — zie Omgevingsvariabelen.
- Variabelen komen bij een dienst aan met de volgende deploy. Voeg je een nieuwe webdienst toe of geef je er een een andere naam, dan krijgen de andere diensten de nieuwe of gewijzigde variabele bij hun volgende deploy. Deploy ze opnieuw zodat ze hem oppikken, bijvoorbeeld met
rivervo deploy <app> --no-build— dat start de draaiende versie opnieuw met de nieuwe variabelen, zonder nieuwe build.
Diensten die alleen intern zijn
Een webdienst die alleen door andere diensten van de applicatie wordt aangeroepen — een API achter je site, een beheerbackend, een zoekmachine — hoeft niet op het internet te staan. Zet hem op Alleen intern:
| Openbaar adres | Alleen intern | |
|---|---|---|
Adres op het internet https://<name>.rivervo.app | ja | nee |
| Eigen domeinen | ja | nee |
| Branch-previews | ja | nee |
| Intern adres voor de andere diensten | ja | ja |
| Meerdere instances en automatisch schalen, logs, monitoring, healthchecks | ja | ja |
Een dienst die alleen intern is, draait zoals elke andere dienst; alleen de andere diensten van dezelfde applicatie kunnen hem bereiken.
Kiezen bij het aanmaken van een dienst
Als je een webdienst aanmaakt — ook de eerste dienst van een nieuwe applicatie, vanuit een repository, een sjabloon of een kant-en-klare image — kies je Openbaar adres of Alleen intern. Er is vooraf niets geselecteerd, dus de keuze ligt altijd bij jou. Achtergrondworkers, geplande taken en databases hebben nooit een openbaar adres, dus daarvoor is er niets te kiezen.
Diensten die zijn aangemaakt voordat deze keuze bestond, houden hun openbare adres.
Later omzetten
De dienst → Instellingen → Openbaar adres: zet de schakelaar om en bevestig. Alleen een Beheerder van de applicatie of de accounteigenaar kan dit wijzigen. Er wordt niets herstart.
- Omzetten naar alleen intern wordt geweigerd zolang er domeinen aan de dienst gekoppeld zijn — verwijder die eerst op het tabblad Domeinen. Ook previews moeten eerst uit.
- Het openbare adres weer aanzetten geeft de dienst hetzelfde adres
https://<name>.rivervo.app. Het certificaat kan ongeveer een minuut duren. - Een domein toevoegen aan een dienst die alleen intern is, wordt geweigerd — zet eerst het openbare adres aan.
Het tabblad Terminal werkt in een dienst die alleen intern is precies zoals in elke andere.
Asynchrone communicatie
De aanroepen hierboven wachten op een antwoord. Moet een dienst werk doorgeven en verdergaan — achtergrondtaken, events waarop meerdere diensten reageren — stuur dan in plaats daarvan berichten via een wachtrij of een message broker: Valkey, NATS of RabbitMQ. Zie Events en wachtrijen.
Meerdere instances
Draait de dienst die je aanroept op meerdere instances, dan leidt zijn interne naam naar al zijn draaiende instances en worden de verbindingen over die instances verdeeld.
Een client die zijn verbindingen openhoudt en hergebruikt (een keep-alive-verbindingspool) kan zijn verzoeken naar dezelfde instance blijven sturen; nieuwe verbindingen worden opnieuw verdeeld. Dat is normaal en hoeft niet ingesteld te worden.
Time-outs en nieuwe pogingen
Tijdens een deploy, of als automatisch schalen een instance stopt, kan een verzoek dat nog loopt mislukken. Met twee gewoontes worden de aanroepen tussen diensten betrouwbaar:
- Een korte time-out — een paar seconden, zodat een aanroep nooit blijft hangen terwijl de instance waar hij naartoe ging aan het stoppen is.
- Eén of twee nieuwe pogingen met een korte pauze, voor verzoeken die veilig herhaald kunnen worden — data lezen met
GET. Herhaal geen verzoeken die data wijzigen (betalingen, bestellingen), tenzij je API een herhaald verzoek van een nieuw verzoek kan onderscheiden.
Voorbeeld: 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()Voorbeeld: Laravel
Zet het adres in config/services.php:
'api' => [
'url' => env('RIVERVO_API_URL'),
],Lees het daarna uit met config(). In productie wordt de configuratie gecachet, en env() buiten de configuratiebestanden geeft dan niets terug:
use Illuminate\Support\Facades\Http;
$orders = Http::timeout(5)
->retry(2, 200)
->get(config('services.api.url').'/orders')
->json();timeout(5) wacht hooguit 5 seconden; retry(2, 200) doet maximaal 2 pogingen met 200 ms ertussen.
Voorbeeld: Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()Met nieuwe pogingen voor 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()Een mislukte GET — een verbindingsfout of een antwoord 502, 503 of 504 — wordt tot 2 keer herhaald, met een korte pauze die elke keer langer wordt.
Via de opdrachtregel en Rivervo MCP
rivervo appsen de details van een dienst tonen het interne adres van elke webdienst en of hij een openbaar adres heeft.rivervo services set-public <service> on|offzet het openbare adres aan of uit. Daarvoor heb je de rol Beheerder nodig en een token met Volledige toegang.- In Rivervo MCP is dezelfde schakelaar de tool
set_public_address.
Zie Ontwikkelaarstools voor tokens en de opdrachtregel.