Kom i gang

Kommunikation mellem tjenester: interne adresser og kun interne tjenester.

Sådan når tjenesterne i én applikation hinanden via den interne adresse, variablerne RIVERVO_<NAME>_URL, tjenester uden offentlig adresse, flere instanser samt timeouts og genforsøg med eksempler til Node.js, Laravel og Python.

6 MIN. LÆSNING

Tjenesterne i én applikation taler direkte med hinanden uden at gå via internettet. En side kan kalde sit eget API, en baggrundsproces kan kalde en intern tjeneste – og denne trafik er gratis: den tælles ikke som trafik.

Eksemplerne nedenfor bruger to webtjenester: web, siden de besøgende åbner, med Offentlig adresse, og api, som kun web og de andre tjenester kalder, sat til Kun intern.

Den interne adresse

Hver webtjeneste – med offentlig adresse eller kun intern – har en Intern adresse på formen http://<service-name>:<port>, for eksempel http://api:8080. Den vises på tjenestens side og på applikationens Oversigt med en kopiknap og tippet «Applikationens andre tjenester når den her – uden internet og uden trafikbetaling.»

  • Porten er 8080 for en tjeneste bygget fra et repositorium eller den Port, du har angivet for en tjeneste fra et færdigt image.
  • Kun tjenester i samme applikation kan nå denne adresse. Den kan ikke åbnes fra internettet eller fra andre applikationer.
  • Adressen bruger http://. Forbindelsen bliver inde i applikationen, så der er intet certifikat at sætte op.

Variabler med adresserne

Du behøver ikke kopiere adresserne ind i din kode. Hver kodetjeneste i applikationen – webtjenester, baggrundsprocesser og planlagte job – får en variabel med den interne adresse på hver anden webtjeneste i applikationen:

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

NAME er tjenestens navn med store bogstaver, hvor bindestreger er erstattet af _:

TjenesteVariabel
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_WEB_URL=http://web:8080
search (fra et færdigt image, port 7700)RIVERVO_SEARCH_URL=http://search:7700
  • En tjeneste får ikke en variabel for sig selv.
  • Databaser og Valkey beholder deres egen RIVERVO_<NAME>_URL med forbindelsesadressen. Tjenestenavne er unikke inden for en applikation, så navnene støder aldrig sammen.
  • Variablerne står på fanen Variabler blandt dem, der er Sat automatisk. Som med alle automatiske variabler træder din egen variabel (eller en delt variabel) med samme navn i stedet – se Miljøvariabler.
  • Variabler når en tjeneste ved dens næste deploy. Når du tilføjer en ny webtjeneste eller omdøber en, får de andre tjenester den nye eller ændrede variabel ved deres næste deploy. Deploy dem igen, så de får den med, for eksempel med rivervo deploy <app> --no-build – det starter den kørende version igen med de nye variabler uden et nyt build.

Kun interne tjenester

En webtjeneste, som kun applikationens andre tjenester kalder – et API bag din side, en admin-backend, en søgemaskine – behøver ikke ligge på internettet. Sæt den til Kun intern:

Offentlig adresseKun intern
Adresse på internettet https://<name>.rivervo.appjanej
Dine egne domænerjanej
Branch-forhåndsvisningerjanej
Intern adresse til de andre tjenesterjaja
Flere instanser og automatisk skalering, logs, overvågning, helbredstjekjaja

En kun intern tjeneste kører som enhver anden tjeneste; kun de andre tjenester i samme applikation kan nå den.

Valg, når du opretter en tjeneste

Når du opretter en webtjeneste – også den første tjeneste i en ny applikation, fra et repositorium, en skabelon eller et færdigt image – vælger du Offentlig adresse eller Kun intern. Intet er valgt på forhånd, så valget er altid dit. Baggrundsprocesser, planlagte job og databaser har aldrig en offentlig adresse, så der er intet valg for dem.

Tjenester, der blev oprettet, før dette valg fandtes, beholder deres offentlige adresse.

Skift senere

Tjenesten → Indstillinger → Offentlig adresse: slå kontakten om, og bekræft. Kun en Administrator af applikationen eller kontoejeren kan ændre det. Intet genstarter.

  • Skift til kun intern afvises, så længe tjenesten har tilsluttede domæner – fjern dem først på dens fane Domæner. Forhåndsvisninger skal også slås fra først.
  • Slår du den offentlige adresse til igen, får tjenesten den samme adresse https://<name>.rivervo.app. Certifikatet kan tage omkring et minut.
  • Tilføjelse af et domæne til en kun intern tjeneste afvises – slå først dens offentlige adresse til.

Fanen Terminal virker i en kun intern tjeneste på samme måde som i enhver anden.

Asynkron kommunikation

Kaldene ovenfor venter på et svar. Når en tjeneste skal aflevere arbejde og fortsætte – baggrundsjob, hændelser som flere tjenester reagerer på – så send i stedet beskeder via en kø eller en message broker: Valkey, NATS eller RabbitMQ. Se Hændelser og køer.

Flere instanser

Når den tjeneste, du kalder, kører flere instanser, fører dens interne navn til alle dens kørende instanser, og forbindelserne fordeles mellem dem.

En klient, der holder sine forbindelser åbne og genbruger dem (en keep-alive-forbindelsespulje), kan blive ved med at sende sine forespørgsler til den samme instans; nye forbindelser fordeles igen. Det er normalt og kræver ingen opsætning.

Timeouts og genforsøg

Under en deploy, eller når automatisk skalering stopper en instans, kan en igangværende forespørgsel fejle. To vaner gør kaldene mellem tjenester pålidelige:

  • En kort timeout – få sekunder, så et kald aldrig hænger, mens den instans, det gik til, er ved at stoppe.
  • Et eller to genforsøg med en kort pause, for forespørgsler der er sikre at gentage – læsning af data med GET. Gentag ikke forespørgsler, der ændrer data (betalinger, ordrer), medmindre dit API kan kende forskel på en gentaget og en ny forespørgsel.

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

Eksempel: Laravel

Læg adressen i config/services.php:

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

Læs den derefter med config(). I produktion caches konfigurationen, og env() kaldt uden for konfigurationsfilerne returnerer ingenting:

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

timeout(5) venter højst 5 sekunder; retry(2, 200) laver op til 2 forsøg med 200 ms imellem.

Eksempel: Python

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

Med genforsøg for 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 fejlet GET – en forbindelsesfejl eller et 502-, 503- eller 504-svar – gentages op til 2 gange med en kort pause, der bliver længere for hver gang.

Fra kommandolinjen og Rivervo MCP

  • rivervo apps og tjenestedetaljerne viser hver webtjenestes interne adresse, og om den har en offentlig adresse.
  • rivervo services set-public <service> on|off slår den offentlige adresse til eller fra. Det kræver rollen Administrator og et token med Fuld adgang.
  • I Rivervo MCP er det samme skift værktøjet set_public_address.

Se Udviklerværktøjer om tokens og kommandolinjen.

Sidder du stadig fast?

Chat med os — AI svarer med det samme, og en tekniker kommer på, når der er brug for det, uanset tidspunktet.

Kontakt support