Zacznij

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.

6 MIN CZYTANIA

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ługaZmienna
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_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>_URL z 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 publicznyTylko wewnętrzna
Adres w internecie https://<name>.rivervo.apptaknie
Własne domenytaknie
Podglądy gałęzitaknie
Adres wewnętrzny dla innych usługtaktak
Kilka instancji i automatyczne skalowanie, logi, monitorowanie, kontrole stanutaktak

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 apps i 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|off przełą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.

Nadal masz pytania?

Napisz do nas na czacie — AI odpowiada od razu, a inżynier dołącza, gdy trzeba, o każdej porze.

Kontakt z pomocą techniczną