Aan de slag

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.

6 MIN LEESTIJD

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 _:

DienstVariabele
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_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>_URL met 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 adresAlleen intern
Adres op het internet https://<name>.rivervo.appjanee
Eigen domeinenjanee
Branch-previewsjanee
Intern adres voor de andere dienstenjaja
Meerdere instances en automatisch schalen, logs, monitoring, healthchecksjaja

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 apps en 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|off zet 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.

Kom je er niet uit?

Chat met ons — de AI antwoordt meteen en een technicus komt erbij als dat nodig is, op elk moment van de dag.

Contact met support