Palveluiden välinen viestintä: sisäiset osoitteet ja vain sisäiset palvelut.
Miten saman sovelluksen palvelut tavoittavat toisensa sisäisen osoitteen kautta, RIVERVO_<NAME>_URL-muuttujat, palvelut ilman julkista osoitetta, useat instanssit sekä aikakatkaisut ja uudelleenyritykset esimerkein Node.js:lle, Laravelille ja Pythonille.
Saman sovelluksen palvelut viestivät keskenään suoraan, internetin kautta kulkematta. Sivusto voi kutsua omaa API:aan, taustaprosessi voi kutsua sisäistä palvelua – ja tämä liikenne on maksutonta: sitä ei lasketa liikenteeksi.
Alla olevissa esimerkeissä on kaksi verkkopalvelua: web, jonka kävijät avaavat ja jolla on Julkinen osoite, sekä api, jota kutsuvat vain web ja muut palvelut ja joka on asetettu tilaan Vain sisäinen.
Sisäinen osoite
Jokaisella verkkopalvelulla – julkisella osoitteella tai vain sisäisellä – on Sisäinen osoite muodossa http://<service-name>:<port>, esimerkiksi http://api:8080. Se näkyy palvelun sivulla ja sovelluksen Yleiskatsauksessa kopiointipainikkeen ja vihjeen kanssa: ”Tämän sovelluksen muut palvelut tavoittavat sen tästä – ei internetiä, ei liikennemaksuja.”
- Portti on 8080 repositoriosta koostetulle palvelulle tai asettamasi Portti valmiista imagesta luodulle palvelulle.
- Vain saman sovelluksen palvelut tavoittavat tämän osoitteen. Se ei aukea internetistä eikä muista sovelluksista.
- Osoite käyttää
http://-muotoa. Yhteys pysyy sovelluksen sisällä, joten varmennetta ei tarvitse määrittää.
Osoitteet sisältävät muuttujat
Osoitteita ei tarvitse kopioida koodiin. Sovelluksen jokainen koodipalvelu – verkkopalvelut, taustaprosessit ja ajastetut tehtävät – saa muuttujan, jossa on sovelluksen jokaisen muun verkkopalvelun sisäinen osoite:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME on palvelun nimi isoin kirjaimin, yhdysviivat muutettuina merkiksi _:
| Palvelu | Muuttuja |
|---|---|
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 (valmiista imagesta, portti 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- Palvelu ei saa muuttujaa itsestään.
- Tietokannat ja Valkey pitävät oman
RIVERVO_<NAME>_URL-muuttujansa, jossa on yhteysosoite. Palveluiden nimet ovat sovelluksen sisällä yksilöllisiä, joten nimet eivät koskaan törmää. - Muuttujat näkyvät Muuttujat-välilehdellä kohdassa Asetettu automaattisesti. Kuten kaikissa automaattisissa muuttujissa, saman niminen oma muuttujasi (tai jaettu muuttuja) korvaa sen – katso Ympäristömuuttujat.
- Muuttujat välittyvät palvelulle sen seuraavassa julkaisussa. Kun lisäät uuden verkkopalvelun tai nimeät sellaisen uudelleen, muut palvelut saavat uuden tai muuttuneen muuttujan seuraavassa julkaisussaan. Julkaise ne uudelleen, jotta ne ottavat sen käyttöön, esimerkiksi komennolla
rivervo deploy <app> --no-build– se käynnistää käynnissä olevan version uudelleen uusilla muuttujilla ilman uutta koontia.
Vain sisäiset palvelut
Verkkopalvelun, jota kutsuvat vain sovelluksen muut palvelut – sivustosi takana oleva API, ylläpidon taustajärjestelmä, hakukone – ei tarvitse olla internetissä. Aseta se tilaan Vain sisäinen:
| Julkinen osoite | Vain sisäinen | |
|---|---|---|
Osoite internetissä https://<name>.rivervo.app | kyllä | ei |
| Omat verkkotunnukset | kyllä | ei |
| Haaraesikatselut | kyllä | ei |
| Sisäinen osoite muille palveluille | kyllä | kyllä |
| Useat instanssit ja automaattinen skaalaus, lokit, valvonta, terveystarkistukset | kyllä | kyllä |
Vain sisäinen palvelu toimii kuten mikä tahansa muu palvelu; vain saman sovelluksen muut palvelut tavoittavat sen.
Valinta palvelua luodessa
Kun luot verkkopalvelun – myös uuden sovelluksen ensimmäisen palvelun, repositoriosta, mallista tai valmiista imagesta – valitse Julkinen osoite tai Vain sisäinen. Mitään ei ole valittu valmiiksi, joten valinta on aina sinun. Taustaprosesseilla, ajastetuilla tehtävillä ja tietokannoilla ei koskaan ole julkista osoitetta, joten niille ei ole valintaa.
Ennen tämän valinnan käyttöönottoa luodut palvelut säilyttävät julkisen osoitteensa.
Vaihtaminen myöhemmin
Palvelu → Asetukset → Julkinen osoite: käännä kytkin ja vahvista. Vain sovelluksen Ylläpitäjä tai tilin omistaja voi muuttaa sitä. Mitään ei käynnistetä uudelleen.
- Vaihto tilaan vain sisäinen estetään, kun palveluun on yhdistetty verkkotunnuksia – poista ne ensin sen Verkkotunnukset-välilehdeltä. Myös esikatselut on ensin poistettava käytöstä.
- Julkisen osoitteen palauttaminen antaa palvelulle saman osoitteen
https://<name>.rivervo.app. Varmenne voi viedä noin minuutin. - Verkkotunnuksen lisääminen vain sisäiseen palveluun estetään – ota ensin sen julkinen osoite käyttöön.
Terminaali-välilehti toimii vain sisäisessä palvelussa samoin kuin missä tahansa muussa.
Asynkroninen viestintä
Yllä olevat kutsut odottavat vastausta. Kun palvelun pitää luovuttaa työ eteenpäin ja jatkaa – taustatehtävät, tapahtumat, joihin useat palvelut reagoivat – lähetä viestit sen sijaan jonon tai viestinvälittäjän kautta: Valkey, NATS tai RabbitMQ. Katso Tapahtumat ja jonot.
Useat instanssit
Kun kutsumasi palvelu ajaa useita instansseja, sen sisäinen nimi johtaa kaikkiin sen käynnissä oleviin instansseihin, ja yhteydet jaetaan niiden kesken.
Asiakas, joka pitää yhteytensä auki ja käyttää niitä uudelleen (keep-alive-yhteyspooli), voi lähettää pyyntönsä jatkuvasti samalle instanssille; uudet yhteydet jaetaan taas. Tämä on normaalia eikä vaadi asetuksia.
Aikakatkaisut ja uudelleenyritykset
Julkaisun aikana tai kun automaattinen skaalaus pysäyttää instanssin, käynnissä oleva pyyntö voi epäonnistua. Kaksi tapaa tekee palveluiden välisistä kutsuista luotettavia:
- Lyhyt aikakatkaisu – muutama sekunti, jotta kutsu ei koskaan jää roikkumaan, kun instanssi, jolle se meni, on pysähtymässä.
- Yksi tai kaksi uudelleenyritystä lyhyellä tauolla pyynnöille, jotka on turvallista toistaa – datan lukeminen
GET-pyynnöllä. Älä toista dataa muuttavia pyyntöjä (maksut, tilaukset), ellei API:si osaa erottaa toistettua pyyntöä uudesta.
Esimerkki: 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()Esimerkki: Laravel
Laita osoite tiedostoon config/services.php:
'api' => [
'url' => env('RIVERVO_API_URL'),
],Lue se sitten funktiolla config(). Tuotannossa konfiguraatio on välimuistissa, ja konfiguraatiotiedostojen ulkopuolella kutsuttu env() ei palauta mitään:
use Illuminate\Support\Facades\Http;
$orders = Http::timeout(5)
->retry(2, 200)
->get(config('services.api.url').'/orders')
->json();timeout(5) odottaa enintään 5 sekuntia; retry(2, 200) tekee enintään 2 yritystä 200 ms:n välein.
Esimerkki: Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()Uudelleenyrityksillä GET-pyynnöille:
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()Epäonnistunut GET – yhteysvirhe tai vastaus 502, 503 tai 504 – toistetaan enintään 2 kertaa, ja lyhyt tauko pitenee joka kerta.
Komentoriviltä ja Rivervo MCP:stä
rivervo appsja palvelun tiedot näyttävät jokaisen verkkopalvelun sisäisen osoitteen ja sen, onko sillä julkinen osoite.rivervo services set-public <service> on|offvaihtaa julkisen osoitteen. Se vaatii Ylläpitäjä-roolin ja tunnisteen, jolla on Täydet oikeudet.- Rivervo MCP:ssä sama kytkin on työkalu
set_public_address.
Katso tunnisteet ja komentorivi kohdasta Kehittäjätyökalut.