Aloita

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.

5 MIN LUKUAIKA

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 _:

PalveluMuuttuja
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_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 osoiteVain sisäinen
Osoite internetissä https://<name>.rivervo.appkylläei
Omat verkkotunnuksetkylläei
Haaraesikatselutkylläei
Sisäinen osoite muille palveluillekylläkyllä
Useat instanssit ja automaattinen skaalaus, lokit, valvonta, terveystarkistuksetkyllä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 apps ja palvelun tiedot näyttävät jokaisen verkkopalvelun sisäisen osoitteen ja sen, onko sillä julkinen osoite.
  • rivervo services set-public <service> on|off vaihtaa 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.

Jäikö jotain epäselväksi?

Kirjoita meille chatissa — AI vastaa heti, ja insinööri liittyy mukaan tarvittaessa mihin aikaan tahansa.

Ota yhteyttä tukeen