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.
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 _:
| Tjeneste | Variabel |
|---|---|
api | RIVERVO_API_URL=http://api:8080 |
admin-api | RIVERVO_ADMIN_API_URL=http://admin-api:8080 |
web | RIVERVO_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>_URLmed 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 adresse | Bare intern | |
|---|---|---|
Adresse på internett https://<name>.rivervo.app | ja | nei |
| Dine egne domener | ja | nei |
| Forhåndsvisninger av grener | ja | nei |
| Intern adresse for de andre tjenestene | ja | ja |
| Flere instanser og automatisk skalering, logger, overvåking, helsesjekker | ja | ja |
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 appsog tjenestedetaljene viser den interne adressen til hver webtjeneste og om den har offentlig adresse.rivervo services set-public <service> on|offslå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.