Komunikacja między usługami: adresy wewnętrzne i usługi tylko wewnętrzne.
Jak usługi jednej aplikacji łączą się ze sobą przez adres wewnętrzny, zmienne RIVERVO_<NAME>_URL, usługi bez adresu publicznego, kilka instancji oraz limity czasu i ponowienia — z przykładami dla Node.js, Laravela i Pythona.
Usługi jednej aplikacji rozmawiają ze sobą bezpośrednio, z pominięciem internetu. Strona może wywoływać własne API, worker może wywoływać usługę wewnętrzną — a ten ruch jest bezpłatny: nie liczy się jako transfer.
W przykładach poniżej występują dwie usługi webowe: web, czyli strona, którą otwierają odwiedzający, z Adresem publicznym, oraz api, które wywołuje tylko web i inne usługi, ustawione jako Tylko wewnętrzna.
Adres wewnętrzny
Każda usługa webowa — z adresem publicznym czy tylko wewnętrzna — ma Adres wewnętrzny w postaci http://<service-name>:<port>, na przykład http://api:8080. Widać go na stronie usługi i w Przeglądzie aplikacji, z przyciskiem kopiowania i podpowiedzią «Pozostałe usługi tej aplikacji docierają do niej tutaj — bez internetu i bez opłat za transfer.»
- Port to 8080 dla usługi budowanej z repozytorium albo Port ustawiony przez ciebie dla usługi z gotowego obrazu.
- Do tego adresu docierają tylko usługi tej samej aplikacji. Nie otwiera się z internetu ani z innych aplikacji.
- Adres używa
http://. Połączenie nie wychodzi poza aplikację, więc nie trzeba konfigurować certyfikatu.
Zmienne z adresami
Nie musisz kopiować adresów do kodu. Każda usługa z kodem w aplikacji — usługi webowe, workery w tle i zadania harmonogramu — dostaje zmienną z adresem wewnętrznym każdej innej usługi webowej aplikacji:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME to nazwa usługi wielkimi literami, z myślnikami zamienionymi na _:
| Usługa | Zmienna |
|---|---|
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 (z gotowego obrazu, port 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- Usługa nie dostaje zmiennej z własnym adresem.
- Bazy danych i Valkey zachowują własne
RIVERVO_<NAME>_URLz adresem połączenia. Nazwy usług są unikalne w obrębie aplikacji, więc nazwy zmiennych nigdy się nie pokrywają. - Zmienne są widoczne na karcie Zmienne wśród zmiennych Ustawiane automatycznie. Jak w przypadku każdej zmiennej automatycznej, twoja własna zmienna (lub zmienna współdzielona) o tej samej nazwie zajmuje jej miejsce — zobacz Zmienne środowiskowe.
- Zmienne docierają do usługi z jej następnym wdrożeniem. Gdy dodasz nową usługę webową albo zmienisz nazwę istniejącej, pozostałe usługi dostaną nową lub zmienioną zmienną przy swoim następnym wdrożeniu. Wdróż je ponownie, żeby ją odczytały, na przykład przez
rivervo deploy <app> --no-build— to uruchamia działającą wersję od nowa z nowymi zmiennymi, bez nowego budowania.
Usługi tylko wewnętrzne
Usługa webowa, którą wywołują tylko inne usługi aplikacji — API za twoją stroną, zaplecze administracyjne, wyszukiwarka — nie musi być dostępna w internecie. Ustaw ją jako Tylko wewnętrzna:
| Adres publiczny | Tylko wewnętrzna | |
|---|---|---|
Adres w internecie https://<name>.rivervo.app | tak | nie |
| Własne domeny | tak | nie |
| Podglądy gałęzi | tak | nie |
| Adres wewnętrzny dla innych usług | tak | tak |
| Kilka instancji i automatyczne skalowanie, logi, monitorowanie, kontrole stanu | tak | tak |
Usługa tylko wewnętrzna działa jak każda inna; docierają do niej jedynie pozostałe usługi tej samej aplikacji.
Wybór przy tworzeniu usługi
Gdy tworzysz usługę webową — także pierwszą usługę nowej aplikacji, z repozytorium, szablonu lub gotowego obrazu — wybierz Adres publiczny albo Tylko wewnętrzna. Nic nie jest zaznaczone z góry, więc decyzja zawsze należy do ciebie. Workery w tle, zadania harmonogramu i bazy danych nigdy nie mają adresu publicznego, więc dla nich nie ma wyboru.
Usługi utworzone, zanim pojawił się ten wybór, zachowują adres publiczny.
Późniejsza zmiana
Usługa → Ustawienia → Adres publiczny: przestaw przełącznik i potwierdź. Zmienić to może tylko Administrator aplikacji lub właściciel konta. Nic się nie restartuje.
- Przełączenie na tylko wewnętrzną jest odrzucane, dopóki usługa ma podłączone domeny — najpierw usuń je na karcie Domeny. Wcześniej trzeba też wyłączyć podglądy.
- Ponowne włączenie adresu publicznego przywraca usłudze ten sam adres
https://<name>.rivervo.app. Certyfikat może się pojawić po około minucie. - Dodanie domeny do usługi tylko wewnętrznej jest odrzucane — najpierw włącz jej adres publiczny.
Karta Terminal działa w usłudze tylko wewnętrznej tak samo jak w każdej innej.
Komunikacja asynchroniczna
Wywołania opisane wyżej czekają na odpowiedź. Gdy usługa ma przekazać pracę i działać dalej — zadania w tle, zdarzenia, na które reaguje kilka usług — wysyłaj zamiast tego wiadomości przez kolejkę lub broker wiadomości: Valkey, NATS lub RabbitMQ. Zobacz Zdarzenia i kolejki.
Kilka instancji
Gdy wywoływana usługa działa w kilku instancjach, jej nazwa wewnętrzna prowadzi do wszystkich działających instancji, a połączenia są między nie rozdzielane.
Klient, który utrzymuje otwarte połączenia i używa ich ponownie (pula połączeń keep-alive), może wysyłać żądania ciągle do tej samej instancji; nowe połączenia są znów rozdzielane. To normalne i nie wymaga konfiguracji.
Limity czasu i ponowienia
Podczas wdrożenia albo gdy automatyczne skalowanie zatrzymuje instancję, trwające żądanie może się nie udać. Dwa nawyki sprawiają, że wywołania między usługami są niezawodne:
- Krótki limit czasu — kilka sekund, żeby wywołanie nigdy nie wisiało, gdy instancja, do której trafiło, właśnie się zatrzymuje.
- Jedno lub dwa ponowienia z krótką przerwą — dla żądań, które można bezpiecznie powtórzyć, czyli odczytu danych przez
GET. Nie powtarzaj żądań, które zmieniają dane (płatności, zamówienia), chyba że twoje API potrafi odróżnić powtórzone żądanie od nowego.
Przykład: 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()Przykład: Laravel
Umieść adres w config/services.php:
'api' => [
'url' => env('RIVERVO_API_URL'),
],Następnie czytaj go przez config(). Na produkcji konfiguracja jest zapisana w cache, a env() wywołane poza plikami konfiguracji nic nie zwraca:
use Illuminate\Support\Facades\Http;
$orders = Http::timeout(5)
->retry(2, 200)
->get(config('services.api.url').'/orders')
->json();timeout(5) czeka najwyżej 5 sekund; retry(2, 200) wykonuje do 2 prób z przerwą 200 ms między nimi.
Przykład: Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()Z ponowieniami dla 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()Nieudane żądanie GET — błąd połączenia albo odpowiedź 502, 503 lub 504 — jest powtarzane do 2 razy, z krótką przerwą, która za każdym razem się wydłuża.
Z wiersza poleceń i w Rivervo MCP
rivervo appsi szczegóły usługi pokazują adres wewnętrzny każdej usługi webowej i to, czy ma adres publiczny.rivervo services set-public <service> on|offprzełącza adres publiczny. Wymaga roli Administrator i tokenu z poziomem Pełny dostęp.- W Rivervo MCP ten sam przełącznik to narzędzie
set_public_address.
Tokeny i wiersz poleceń opisujemy w Narzędzia dla programistów.