Kom igång

Kommunikation mellan tjänster: interna adresser och endast interna tjänster.

Hur tjänsterna i en applikation når varandra via den interna adressen, variablerna RIVERVO_<NAME>_URL, tjänster utan publik adress, flera instanser samt tidsgränser och nya försök med exempel för Node.js, Laravel och Python.

6 MIN LÄSNING

Tjänsterna i en applikation pratar direkt med varandra, utan att gå via internet. En sajt kan anropa sitt eget API, en bakgrundsprocess kan anropa en intern tjänst – och den här trafiken är gratis: den räknas inte som trafik.

Exemplen nedan använder två webbtjänster: web, sajten som besökarna öppnar, med Publik adress, och api, som bara web och de andra tjänsterna anropar, inställd på Endast intern.

Den interna adressen

Varje webbtjänst – med publik adress eller endast intern – har en Intern adress i formen http://<service-name>:<port>, till exempel http://api:8080. Den visas på tjänstens sida och i applikationens Översikt, med en kopieringsknapp och tipset «Applikationens andra tjänster når den här – utan internet, utan trafikavgifter.»

  • Porten är 8080 för en tjänst byggd från ett repo, eller den Port du angett för en tjänst från en färdig image.
  • Bara tjänsterna i samma applikation kan nå adressen. Den går inte att öppna från internet eller från andra applikationer.
  • Adressen använder http://. Anslutningen stannar inom applikationen, så det finns inget certifikat att ställa in.

Variabler med adresserna

Du behöver inte kopiera adresserna in i din kod. Varje kodtjänst i applikationen – webbtjänster, bakgrundsprocesser och schemalagda jobb – får en variabel med den interna adressen till varje annan webbtjänst i applikationen:

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

NAME är tjänstens namn med versaler, där bindestreck blir _:

TjänstVariabel
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_WEB_URL=http://web:8080
search (från en färdig image, port 7700)RIVERVO_SEARCH_URL=http://search:7700
  • En tjänst får ingen variabel för sig själv.
  • Databaser och Valkey behåller sin egen RIVERVO_<NAME>_URL med anslutningsadressen. Tjänstnamn är unika inom en applikation, så namnen krockar aldrig.
  • Variablerna listas på fliken Variabler bland variablerna under Sätts automatiskt. Som för alla automatiska variabler tar en egen variabel (eller en delad variabel) med samma namn dess plats – se Miljövariabler.
  • Variabler når en tjänst vid dess nästa driftsättning. När du lägger till en ny webbtjänst eller byter namn på en får de andra tjänsterna den nya eller ändrade variabeln vid sin nästa driftsättning. Driftsätt dem igen så att de läser in den, till exempel med rivervo deploy <app> --no-build – det startar den körande versionen på nytt med de nya variablerna, utan nytt bygge.

Endast interna tjänster

En webbtjänst som bara applikationens andra tjänster anropar – ett API bakom din sajt, en admin-backend, en sökmotor – behöver inte finnas på internet. Ställ in den på Endast intern:

Publik adressEndast intern
Adress på internet https://<name>.rivervo.appjanej
Egna domänerjanej
Förhandsvisningar av grenarjanej
Intern adress för de andra tjänsternajaja
Flera instanser och automatisk skalning, loggar, övervakning, hälsokontrollerjaja

En endast intern tjänst körs som vilken annan tjänst som helst; bara de andra tjänsterna i samma applikation kan nå den.

Välj när du skapar en tjänst

När du skapar en webbtjänst – även den första tjänsten i en ny applikation, från ett repo, en mall eller en färdig image – väljer du Publik adress eller Endast intern. Inget är förvalt, så valet är alltid ditt. Bakgrundsprocesser, schemalagda jobb och databaser har aldrig en publik adress, så för dem finns inget val.

Tjänster som skapades innan det här valet fanns behåller sin publika adress.

Byt senare

Tjänsten → Inställningar → Publik adress: slå om reglaget och bekräfta. Bara en Administratör för applikationen eller kontoägaren kan ändra det. Inget startas om.

  • Byte till endast intern nekas så länge tjänsten har domäner anslutna – ta först bort dem på dess flik Domäner. Förhandsvisningar måste också stängas av först.
  • När du slår på den publika adressen igen får tjänsten samma adress https://<name>.rivervo.app. Certifikatet kan ta ungefär en minut.
  • Att lägga till en domän till en endast intern tjänst nekas – slå först på dess publika adress.

Fliken Terminal fungerar i en endast intern tjänst på samma sätt som i alla andra.

Asynkron kommunikation

Anropen ovan väntar på svar. När en tjänst ska lämna över arbete och gå vidare – bakgrundsjobb, händelser som flera tjänster reagerar på – skickar du i stället meddelanden via en kö eller en meddelandeförmedlare: Valkey, NATS eller RabbitMQ. Se Händelser och köer.

Flera instanser

När tjänsten du anropar kör flera instanser leder dess interna namn till alla dess körande instanser, och anslutningarna fördelas mellan dem.

En klient som håller sina anslutningar öppna och återanvänder dem (en anslutningspool med keep-alive) kan fortsätta skicka sina förfrågningar till samma instans; nya anslutningar fördelas på nytt. Det är normalt och kräver ingen inställning.

Tidsgränser och nya försök

Under en driftsättning, eller när den automatiska skalningen stoppar en instans, kan en pågående förfrågan misslyckas. Två vanor gör anropen mellan tjänster pålitliga:

  • En kort tidsgräns – några sekunder, så att ett anrop aldrig hänger medan instansen det gick till håller på att stoppas.
  • Ett eller två nya försök med en kort paus, för förfrågningar som är säkra att upprepa – läsning av data med GET. Upprepa inte förfrågningar som ändrar data (betalningar, ordrar) om inte ditt API kan skilja en upprepad förfrågan från en ny.

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

Exempel: Laravel

Lägg adressen i config/services.php:

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

Läs den sedan med config(). I produktion cachas konfigurationen, och env() som anropas utanför konfigurationsfilerna returnerar ingenting:

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

timeout(5) väntar högst 5 sekunder; retry(2, 200) gör upp till 2 försök med 200 ms emellan.

Exempel: Python

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

Med nya försök 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()

En misslyckad GET – ett anslutningsfel eller svaret 502, 503 eller 504 – upprepas upp till 2 gånger, med en kort paus som blir längre för varje gång.

Från kommandoraden och Rivervo MCP

  • rivervo apps och tjänstdetaljerna visar varje webbtjänsts interna adress och om den har en publik adress.
  • rivervo services set-public <service> on|off slår av eller på den publika adressen. Det kräver rollen Administratör och en token med Full åtkomst.
  • I Rivervo MCP är samma omkopplare verktyget set_public_address.

Se Utvecklarverktyg om tokens och kommandoraden.

Fortfarande fast?

Chatta med oss — AI svarar direkt och en tekniker kopplas in vid behov, när som helst på dygnet.

Kontakta supporten