Začít

Komunikace mezi službami: interní adresy a služby pouze interní.

Jak se služby jedné aplikace navzájem spojí přes interní adresu, proměnné RIVERVO_<NAME>_URL, služby bez veřejné adresy, více instancí a timeouty a opakování s příklady pro Node.js, Laravel a Python.

5 MIN ČTENÍ

Služby jedné aplikace spolu komunikují přímo, bez cesty přes internet. Web může volat vlastní API, worker může volat interní službu — a tento provoz je zdarma: do provozu se nezapočítává.

Příklady níže používají dvě webové služby: web, kterou otevírají návštěvníci, s Veřejnou adresou, a api, kterou volá jen web a ostatní služby, nastavenou jako Pouze interní.

Interní adresa

Každá webová služba — s veřejnou adresou i pouze interní — má Interní adresu ve tvaru http://<service-name>:<port>, například http://api:8080. Zobrazuje se na stránce služby a v Přehledu aplikace, s tlačítkem pro zkopírování a nápovědou „Ostatní služby této aplikace se k ní dostanou tady — bez internetu, bez poplatků za provoz.“

  • Port je 8080 u služby sestavené z repozitáře, nebo Port, který jste nastavili u služby z hotového image.
  • K této adrese se dostanou jen služby téže aplikace. Z internetu ani z jiných aplikací se neotevře.
  • Adresa používá http://. Spojení zůstává uvnitř aplikace, takže není potřeba nastavovat certifikát.

Proměnné s adresami

Adresy nemusíte kopírovat do kódu. Každá kódová služba aplikace — webové služby, workery na pozadí i plánované úlohy — dostane proměnnou s interní adresou každé další webové služby aplikace:

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

NAME je název služby velkými písmeny, pomlčky se mění na _:

SlužbaProměnná
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_WEB_URL=http://web:8080
search (z hotového image, port 7700)RIVERVO_SEARCH_URL=http://search:7700
  • Služba nedostane proměnnou sama pro sebe.
  • Databáze a Valkey mají vlastní RIVERVO_<NAME>_URL s adresou pro připojení. Názvy služeb jsou v rámci aplikace jedinečné, takže se názvy nikdy nepřekrývají.
  • Proměnné najdete na kartě Proměnné mezi proměnnými Nastaveno automaticky. Jako u každé automatické proměnné ji nahradí vlastní (nebo sdílená) proměnná se stejným názvem — viz Proměnné prostředí.
  • Proměnné se do služby dostanou s jejím příštím nasazením. Když přidáte novou webovou službu nebo nějakou přejmenujete, ostatní služby dostanou novou nebo změněnou proměnnou při svém příštím nasazení. Nasaďte je znovu, aby ji načetly, například příkazem rivervo deploy <app> --no-build — znovu spustí běžící verzi s novými proměnnými, bez nového sestavení.

Služby pouze interní

Webová služba, kterou volají jen ostatní služby aplikace — API za vaším webem, administrační backend, vyhledávač —, nemusí být v internetu. Nastavte ji jako Pouze interní:

Veřejná adresaPouze interní
Adresa v internetu https://<name>.rivervo.appanone
Vlastní doményanone
Náhledy větvíanone
Interní adresa pro ostatní službyanoano
Více instancí a automatické škálování, logy, monitoring, kontroly stavuanoano

Služba pouze interní běží jako kterákoli jiná služba; dostanou se k ní jen ostatní služby téže aplikace.

Volba při vytváření služby

Když vytváříte webovou službu — včetně první služby nové aplikace, z repozitáře, šablony nebo hotového image —, zvolte Veřejná adresa nebo Pouze interní. Předem není vybráno nic, takže volba je vždy na vás. Workery na pozadí, plánované úlohy a databáze veřejnou adresu nikdy nemají, takže u nich se nic nevolí.

Služby vytvořené dřív, než tato volba existovala, si veřejnou adresu ponechávají.

Pozdější přepnutí

Služba → Nastavení → Veřejná adresa: přepněte přepínač a potvrďte. Změnit to může jen Administrátor aplikace nebo vlastník účtu. Nic se nerestartuje.

  • Přepnutí na pouze interní se odmítne, dokud má služba připojené domény — nejdřív je odeberte na její kartě Domény. Vypnout je předtím potřeba i náhledy.
  • Opětovné zapnutí veřejné adresy dá službě stejnou adresu https://<name>.rivervo.app. Certifikát může trvat asi minutu.
  • Přidání domény ke službě pouze interní se odmítne — nejdřív zapněte její veřejnou adresu.

Karta Terminál funguje ve službě pouze interní stejně jako v kterékoli jiné.

Asynchronní komunikace

Výše popsaná volání čekají na odpověď. Když má služba práci předat a pokračovat dál — úlohy na pozadí, události, na které reaguje několik služeb —, posílejte místo toho zprávy přes frontu nebo message broker: Valkey, NATS nebo RabbitMQ. Viz Události a fronty.

Více instancí

Když volaná služba běží ve více instancích, její interní název vede na všechny její běžící instance a spojení se mezi ně rozdělují.

Klient, který spojení drží otevřená a znovu je používá (pool keep-alive spojení), může posílat požadavky stále na stejnou instanci; nová spojení se rozdělí znovu. To je normální a nevyžaduje žádné nastavení.

Timeouty a opakování

Během nasazení, nebo když automatické škálování zastaví instanci, může probíhající požadavek selhat. Volání mezi službami udělají spolehlivými dva návyky:

  • Krátký timeout — pár sekund, aby volání nikdy neviselo, zatímco se instance, na kterou šlo, zastavuje.
  • Jedno nebo dvě opakování s krátkou pauzou u požadavků, které je bezpečné zopakovat — čtení dat přes GET. Neopakujte požadavky, které mění data (platby, objednávky), pokud vaše API neumí opakovaný požadavek odlišit od nového.

Příklad: 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()

Příklad: Laravel

Adresu uložte do config/services.php:

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

Pak ji čtěte přes config(). V produkci je konfigurace uložená v cache a env() volané mimo konfigurační soubory nevrací nic:

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

timeout(5) čeká nejvýše 5 sekund; retry(2, 200) udělá až 2 pokusy s odstupem 200 ms.

Příklad: Python

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

S opakováním u 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()

Neúspěšný GET — chyba spojení nebo odpověď 502, 503 či 504 — se zopakuje až dvakrát, s krátkou pauzou, která se pokaždé prodlužuje.

Z příkazové řádky a z Rivervo MCP

  • rivervo apps a podrobnosti služby ukazují interní adresu každé webové služby a to, zda má veřejnou adresu.
  • rivervo services set-public <service> on|off přepíná veřejnou adresu. Vyžaduje roli Administrátor a token s úrovní Plný přístup.
  • V Rivervo MCP slouží ke stejnému přepnutí nástroj set_public_address.

Tokeny a příkazovou řádku popisuje článek Nástroje pro vývojáře.

Pořád si nevíte rady?

Napište nám do chatu — AI odpoví hned a technik se připojí, když je potřeba, v kteroukoli denní dobu.

Kontaktovat podporu