Kom i gang

Kommunikasjon mellom tjenester: interne adresser og tjenester som bare er interne.

Slik når tjenestene i én applikasjon hverandre via den interne adressen, RIVERVO_<NAME>_URL-variablene, tjenester uten offentlig adresse, flere instanser, og tidsavbrudd og nye forsøk med eksempler for Node.js, Laravel og Python.

6 MIN LESING

Tjenestene i én applikasjon snakker direkte med hverandre, uten å gå via internett. En nettside kan kalle sitt eget API, en bakgrunnsprosess kan kalle en intern tjeneste – og denne trafikken er gratis: den telles ikke som trafikk.

Eksemplene nedenfor bruker to webtjenester: web, nettsiden de besøkende åpner, med Offentlig adresse, og api, som bare web og de andre tjenestene kaller, satt til Bare intern.

Den interne adressen

Hver webtjeneste – med offentlig adresse eller bare intern – har en Intern adresse på formen http://<service-name>:<port>, for eksempel http://api:8080. Den vises på tjenestens side og i applikasjonens Oversikt, med en kopieringsknapp og tipset «Andre tjenester i denne applikasjonen når den her – uten internett og uten trafikkostnader.»

  • Porten er 8080 for en tjeneste som er bygget fra et repositorium, eller Porten du angir for en tjeneste fra et ferdig image.
  • Bare tjenestene i samme applikasjon kan nå denne adressen. Den åpnes ikke fra internett eller fra andre applikasjoner.
  • Adressen bruker http://. Tilkoblingen holder seg inne i applikasjonen, så det er ikke noe sertifikat å sette opp.

Variabler med adressene

Du trenger ikke kopiere adressene inn i koden. Hver kodetjeneste i applikasjonen – webtjenester, bakgrunnsprosesser og planlagte jobber – får en variabel med den interne adressen til hver av de andre webtjenestene i applikasjonen:

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

NAME er tjenestens navn med store bokstaver, der bindestreker er gjort om til _:

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 ferdig image, port 7700)RIVERVO_SEARCH_URL=http://search:7700
  • En tjeneste får ikke en variabel for seg selv.
  • Databaser og Valkey beholder sin egen RIVERVO_<NAME>_URL med tilkoblingsadressen. Tjenestenavn er unike innenfor en applikasjon, så navnene kolliderer aldri.
  • Variablene vises på fanen Variabler blant variablene som er Satt automatisk. Som for alle automatiske variabler tar en egen variabel (eller en delt variabel) med samme navn plassen deres – se Miljøvariabler.
  • Variabler når en tjeneste ved neste utrulling. Når du legger til en ny webtjeneste eller gir en nytt navn, får de andre tjenestene den nye eller endrede variabelen ved sin neste utrulling. Rull dem ut på nytt slik at de får den, for eksempel med rivervo deploy <app> --no-build – det starter den kjørende versjonen på nytt med de nye variablene, uten ny bygging.

Tjenester som bare er interne

En webtjeneste som bare andre tjenester i applikasjonen kaller – et API bak nettsiden din, en administrasjonsbackend, en søkemotor – trenger ikke ligge på internett. Sett den til Bare intern:

Offentlig adresseBare intern
Adresse på internett https://<name>.rivervo.appjanei
Dine egne domenerjanei
Forhåndsvisninger av grenerjanei
Intern adresse for de andre tjenestenejaja
Flere instanser og automatisk skalering, logger, overvåking, helsesjekkerjaja

En tjeneste som bare er intern, kjører som alle andre tjenester. Bare de andre tjenestene i samme applikasjon kan nå den.

Valget når du oppretter en tjeneste

Når du oppretter en webtjeneste – også den første tjenesten i en ny applikasjon, fra et repositorium, en mal eller et ferdig image – velger du Offentlig adresse eller Bare intern. Ingenting er forhåndsvalgt, så valget er alltid ditt. Bakgrunnsprosesser, planlagte jobber og databaser har aldri offentlig adresse, så for dem er det ikke noe valg.

Tjenester som ble opprettet før dette valget fantes, beholder den offentlige adressen sin.

Bytte senere

Tjenesten → Innstillinger → Offentlig adresse: slå bryteren og bekreft. Bare en Administrator for applikasjonen eller kontoeieren kan endre dette. Ingenting startes på nytt.

  • Bytte til bare intern avvises så lenge tjenesten har tilkoblede domener – fjern dem først på fanen Domener. Forhåndsvisninger må også slås av først.
  • Slå på den offentlige adressen igjen gir tjenesten den samme https://<name>.rivervo.app-adressen. Sertifikatet kan ta omtrent ett minutt.
  • Å legge til et domene på en tjeneste som bare er intern, avvises – slå på den offentlige adressen først.

Fanen Terminal fungerer i en tjeneste som bare er intern, på samme måte som i alle andre.

Asynkron kommunikasjon

Kallene ovenfor venter på svar. Når en tjeneste skal gi fra seg arbeid og gå videre – bakgrunnsjobber, hendelser som flere tjenester reagerer på – sender du heller meldinger via en kø eller en meldingsmegler: Valkey, NATS eller RabbitMQ. Se Hendelser og køer.

Flere instanser

Når tjenesten du kaller, kjører flere instanser, leder det interne navnet til alle de kjørende instansene, og tilkoblingene fordeles mellom dem.

En klient som holder tilkoblingene åpne og gjenbruker dem (en keep-alive-tilkoblingspool), kan fortsette å sende forespørslene sine til samme instans. Nye tilkoblinger fordeles på nytt. Dette er normalt og krever ikke noe oppsett.

Tidsavbrudd og nye forsøk

Under en utrulling, eller når automatisk skalering stopper en instans, kan en forespørsel som pågår, feile. To vaner gjør kallene mellom tjenestene pålitelige:

  • Et kort tidsavbrudd – noen sekunder, slik at et kall aldri henger mens instansen det gikk til, stopper.
  • Ett eller to nye forsøk med en kort pause, for forespørsler som trygt kan gjentas – lesing av data med GET. Ikke gjenta forespørsler som endrer data (betalinger, bestillinger), med mindre API-et ditt kan skille en gjentatt forespørsel fra en ny.

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

Legg adressen i config/services.php:

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

Les den deretter med config(). I produksjon er konfigurasjonen bufret, og env() som kalles utenfor konfigurasjonsfilene, returnerer ingenting:

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

timeout(5) venter i maks 5 sekunder; retry(2, 200) gjør opptil 2 forsøk med 200 ms mellom dem.

Eksempel: Python

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

Med nye forsøk 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 mislykket GET – en tilkoblingsfeil eller et 502-, 503- eller 504-svar – gjentas opptil 2 ganger, med en kort pause som blir lengre hver gang.

Fra kommandolinjen og Rivervo MCP

  • rivervo apps og tjenestedetaljene viser den interne adressen til hver webtjeneste og om den har offentlig adresse.
  • rivervo services set-public <service> on|off slår den offentlige adressen av eller på. Det krever rollen Administrator og et token med Full tilgang.
  • I Rivervo MCP er den samme bryteren verktøyet set_public_address.

Se Utviklerverktøy for tokener og kommandolinjen.

Står du fast?

Chat med oss – AI svarer med en gang, og en tekniker kommer inn når det trengs, når som helst på døgnet.

Kontakt kundestøtte