Jetzt starten

Kommunikation zwischen Diensten: interne Adressen und rein interne Dienste.

Wie sich die Dienste einer Anwendung über die interne Adresse erreichen, die Variablen RIVERVO_<NAME>_URL, Dienste ohne öffentliche Adresse, mehrere Instanzen sowie Timeouts und Wiederholungen mit Beispielen für Node.js, Laravel und Python.

6 MIN. LESEZEIT

Die Dienste einer Anwendung kommunizieren direkt miteinander, ohne den Umweg über das Internet. Eine Website kann ihre eigene API aufrufen, ein Worker einen internen Dienst – und dieser Datenverkehr ist kostenlos: Er zählt nicht als Traffic.

Die Beispiele unten verwenden zwei Webdienste: web, die Website, die Besucher öffnen, mit Öffentlicher Adresse, und api, den nur web und die anderen Dienste aufrufen, eingestellt auf Nur intern.

Die interne Adresse

Jeder Webdienst – ob mit öffentlicher Adresse oder nur intern – hat eine Interne Adresse der Form http://<service-name>:<port>, zum Beispiel http://api:8080. Sie wird auf der Seite des Dienstes und in der Übersicht der Anwendung angezeigt, mit einer Schaltfläche zum Kopieren und dem Hinweis „Andere Dienste dieser Anwendung erreichen ihn hier – ohne Internet, ohne Traffic-Kosten.“

  • Der Port ist 8080 bei einem Dienst, der aus einem Repository gebaut wird, oder der Port, den Sie für einen Dienst aus einem fertigen Image festgelegt haben.
  • Nur die Dienste derselben Anwendung erreichen diese Adresse. Aus dem Internet oder aus anderen Anwendungen ist sie nicht erreichbar.
  • Die Adresse verwendet http://. Die Verbindung bleibt innerhalb der Anwendung, ein Zertifikat müssen Sie also nicht einrichten.

Variablen mit den Adressen

Sie müssen die Adressen nicht in Ihren Code kopieren. Jeder Code-Dienst der Anwendung – Webdienste, Hintergrund-Worker und geplante Jobs – erhält eine Variable mit der internen Adresse jedes anderen Webdienstes der Anwendung:

RIVERVO_<NAME>_URL=http://<name>:<port>

NAME ist der Name des Dienstes in Großbuchstaben, Bindestriche werden zu _:

DienstVariable
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_WEB_URL=http://web:8080
search (aus einem fertigen Image, Port 7700)RIVERVO_SEARCH_URL=http://search:7700
  • Für sich selbst erhält ein Dienst keine Variable.
  • Datenbanken und Valkey behalten ihre eigene RIVERVO_<NAME>_URL mit der Verbindungsadresse. Dienstnamen sind innerhalb einer Anwendung eindeutig, die Namen kollidieren also nie.
  • Die Variablen stehen im Tab Variablen unter Automatisch gesetzt. Wie bei jeder automatischen Variable tritt eine eigene Variable (oder eine gemeinsame Variable) mit demselben Namen an ihre Stelle – siehe Umgebungsvariablen.
  • Variablen erreichen einen Dienst mit seinem nächsten Deployment. Wenn Sie einen neuen Webdienst hinzufügen oder einen umbenennen, erhalten die anderen Dienste die neue oder geänderte Variable bei ihrem nächsten Deployment. Deployen Sie sie erneut, damit sie sie übernehmen, zum Beispiel mit rivervo deploy <app> --no-build – das startet die laufende Version mit den neuen Variablen neu, ohne neuen Build.

Rein interne Dienste

Ein Webdienst, den nur andere Dienste der Anwendung aufrufen – eine API hinter Ihrer Website, ein Admin-Backend, eine Suchmaschine –, muss nicht im Internet erreichbar sein. Stellen Sie ihn auf Nur intern:

Öffentliche AdresseNur intern
Adresse im Internet https://<name>.rivervo.appjanein
Eigene Domainsjanein
Branch-Vorschauenjanein
Interne Adresse für die anderen Dienstejaja
Mehrere Instanzen und automatische Skalierung, Logs, Monitoring, Health-Checksjaja

Ein rein interner Dienst läuft wie jeder andere Dienst; nur die anderen Dienste derselben Anwendung erreichen ihn.

Auswahl beim Anlegen eines Dienstes

Wenn Sie einen Webdienst anlegen – auch den ersten Dienst einer neuen Anwendung, aus einem Repository, einer Vorlage oder einem fertigen Image –, wählen Sie Öffentliche Adresse oder Nur intern. Vorausgewählt ist nichts, die Entscheidung liegt also immer bei Ihnen. Hintergrund-Worker, geplante Jobs und Datenbanken haben nie eine öffentliche Adresse, daher gibt es für sie keine Auswahl.

Dienste, die angelegt wurden, bevor es diese Auswahl gab, behalten ihre öffentliche Adresse.

Später umstellen

Im Dienst → Einstellungen → Öffentliche Adresse: Schalter umlegen und bestätigen. Ändern können das nur ein Administrator der Anwendung oder der Kontoinhaber. Dabei wird nichts neu gestartet.

  • Die Umstellung auf „Nur intern“ wird abgelehnt, solange mit dem Dienst Domains verbunden sind – entfernen Sie sie zuerst im Tab Domains. Auch Vorschauen müssen vorher ausgeschaltet werden.
  • Wenn Sie die öffentliche Adresse wieder einschalten, erhält der Dienst dieselbe Adresse https://<name>.rivervo.app. Das Zertifikat kann etwa eine Minute dauern.
  • Eine Domain zu einem rein internen Dienst hinzuzufügen wird abgelehnt – schalten Sie zuerst seine öffentliche Adresse ein.

Der Tab Terminal funktioniert in einem rein internen Dienst genauso wie in jedem anderen.

Asynchrone Kommunikation

Die oben beschriebenen Aufrufe warten auf eine Antwort. Soll ein Dienst Arbeit übergeben und weitermachen – Hintergrundjobs, Ereignisse, auf die mehrere Dienste reagieren –, senden Sie Nachrichten stattdessen über eine Warteschlange oder einen Message-Broker: Valkey, NATS oder RabbitMQ. Siehe Ereignisse und Warteschlangen.

Mehrere Instanzen

Läuft der aufgerufene Dienst in mehreren Instanzen, führt sein interner Name zu allen laufenden Instanzen, und die Verbindungen werden auf sie verteilt.

Ein Client, der seine Verbindungen offen hält und wiederverwendet (ein Keep-Alive-Verbindungspool), schickt seine Anfragen unter Umständen weiter an dieselbe Instanz; neue Verbindungen werden wieder verteilt. Das ist normal und erfordert keine Einrichtung.

Timeouts und Wiederholungen

Während eines Deployments oder wenn die automatische Skalierung eine Instanz stoppt, kann eine laufende Anfrage fehlschlagen. Zwei Gewohnheiten machen die Aufrufe zwischen Diensten zuverlässig:

  • Ein kurzer Timeout – wenige Sekunden, damit ein Aufruf nie hängen bleibt, während die angesprochene Instanz gerade stoppt.
  • Ein oder zwei Wiederholungen mit kurzer Pause, bei Anfragen, die sich gefahrlos wiederholen lassen – Daten lesen mit GET. Wiederholen Sie keine Anfragen, die Daten ändern (Zahlungen, Bestellungen), es sei denn, Ihre API kann eine wiederholte Anfrage von einer neuen unterscheiden.

Beispiel: 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()

Beispiel: Laravel

Hinterlegen Sie die Adresse in config/services.php:

'api' => [
    'url' => env('RIVERVO_API_URL'),
],

Lesen Sie sie dann mit config() aus. In der Produktion wird die Konfiguration gecacht, und env() liefert außerhalb der Konfigurationsdateien nichts zurück:

use Illuminate\Support\Facades\Http;
 
$orders = Http::timeout(5)
    ->retry(2, 200)
    ->get(config('services.api.url').'/orders')
    ->json();

timeout(5) wartet höchstens 5 Sekunden; retry(2, 200) unternimmt bis zu 2 Versuche mit 200 ms Abstand.

Beispiel: Python

import os
import requests
 
API = os.environ["RIVERVO_API_URL"]
 
orders = requests.get(f"{API}/orders", timeout=5).json()

Mit Wiederholungen für 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()

Ein fehlgeschlagenes GET – ein Verbindungsfehler oder eine Antwort 502, 503 oder 504 – wird bis zu 2-mal wiederholt, mit einer kurzen Pause, die jedes Mal länger wird.

Über die Kommandozeile und Rivervo MCP

  • rivervo apps und die Details eines Dienstes zeigen die interne Adresse jedes Webdienstes und ob er eine öffentliche Adresse hat.
  • rivervo services set-public <service> on|off schaltet die öffentliche Adresse um. Dafür sind die Rolle Administrator und ein Token mit Vollzugriff nötig.
  • In Rivervo MCP entspricht dem das Tool set_public_address.

Zu Tokens und der Kommandozeile siehe Entwicklerwerkzeuge.

Noch Fragen?

Schreiben Sie uns im Chat – die AI antwortet sofort, und bei Bedarf kommt ein Techniker dazu, zu jeder Tageszeit.

Support kontaktieren