Комуникация между услугите: вътрешни адреси и само вътрешни услуги.
Как услугите на едно приложение се достигат една друга по вътрешния адрес, променливите RIVERVO_<NAME>_URL, услуги без публичен адрес, няколко инстанции, таймаути и повторни опити с примери за Node.js, Laravel и Python.
Услугите на едно приложение комуникират помежду си директно, без да минават през интернет. Сайтът може да извиква собствения си API, фонов процес може да извиква вътрешна услуга — и този трафик е безплатен: не се брои като трафик.
Примерите по-долу използват две уеб услуги: web — сайтът, който посетителите отварят, с Публичен адрес, и api, която се извиква само от web и другите услуги, настроена като Само вътрешна.
Вътрешният адрес
Всяка уеб услуга — с публичен адрес или само вътрешна — има Вътрешен адрес във вида http://<service-name>:<port>, например http://api:8080. Той се показва на страницата на услугата и в Преглед на приложението, с бутон за копиране и подсказка „Другите услуги на това приложение я достигат тук — без интернет и без такси за трафик.“
- Портът е 8080 за услуга, изградена от хранилище, или зададеният от вас Порт за услуга от готов образ.
- Само услугите на същото приложение могат да достигнат този адрес. Той не се отваря от интернет или от други приложения.
- Адресът използва
http://. Връзката остава вътре в приложението, затова няма сертификат за настройване.
Променливи с адресите
Не е нужно да копирате адресите в кода си. Всяка услуга с код на приложението — уеб услуги, фонови процеси и задачи по график — получава променлива с вътрешния адрес на всяка друга уеб услуга на приложението:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME е името на услугата с главни букви, като тиретата се заменят с _:
| Услуга | Променлива |
|---|---|
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 (от готов образ, порт 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- Услугата не получава променлива за самата себе си.
- Базите данни и Valkey запазват собствената си
RIVERVO_<NAME>_URLс адреса за връзка. Имената на услугите са уникални в рамките на приложението, затова имената никога не се засичат. - Променливите са изброени в раздела Променливи сред Зададените автоматично. Както при всяка автоматична променлива, ваша променлива (или споделена променлива) със същото име заема мястото ѝ — вижте Променливи на средата.
- Променливите стигат до услугата със следващия ѝ деплой. Когато добавите нова уеб услуга или преименувате съществуваща, другите услуги получават новата или променената променлива при следващия си деплой. Деплойнете ги отново, за да я вземат, например с
rivervo deploy <app> --no-build— така работещата версия се стартира отново с новите променливи, без ново изграждане.
Само вътрешни услуги
Уеб услуга, която се извиква само от други услуги на приложението — API зад сайта ви, административен бекенд, търсачка, — не е нужно да е в интернет. Задайте ѝ Само вътрешна:
| Публичен адрес | Само вътрешна | |
|---|---|---|
Адрес в интернет https://<name>.rivervo.app | да | не |
| Ваши домейни | да | не |
| Прегледи на клонове | да | не |
| Вътрешен адрес за другите услуги | да | да |
| Няколко инстанции и автоматично мащабиране, логове, мониторинг, проверки на състоянието | да | да |
Само вътрешната услуга работи като всяка друга; единствено другите услуги на същото приложение могат да я достигнат.
Избор при създаване на услуга
Когато създавате уеб услуга — включително първата услуга на ново приложение, от хранилище, шаблон или готов образ, — изберете Публичен адрес или Само вътрешна. Нищо не е избрано предварително, така че изборът винаги е ваш. Фоновите процеси, задачите по график и базите данни никога нямат публичен адрес, затова при тях няма избор.
Услугите, създадени преди да се появи този избор, запазват публичния си адрес.
Промяна по-късно
Услугата → Настройки → Публичен адрес: превключете и потвърдете. Само Администратор на приложението или собственикът на акаунта може да промени това. Нищо не се рестартира.
- Превключването към само вътрешна се отказва, докато към услугата има свързани домейни — първо ги премахнете в раздела ѝ Домейни. Прегледите също трябва първо да бъдат изключени.
- Повторното включване на публичния адрес дава на услугата същия адрес
https://<name>.rivervo.app. Сертификатът може да отнеме около минута. - Добавянето на домейн към само вътрешна услуга се отказва — първо включете публичния ѝ адрес.
Разделът Терминал работи в само вътрешна услуга по същия начин като във всяка друга.
Асинхронна комуникация
Извикванията по-горе чакат отговор. Когато услугата трябва да предаде работа и да продължи — фонови задачи, събития, на които реагират няколко услуги, — изпращайте вместо това съобщения през опашка или брокер на съобщения: Valkey, NATS или RabbitMQ. Вижте Събития и опашки.
Няколко инстанции
Когато извикваната услуга работи с няколко инстанции, вътрешното ѝ име води до всички нейни работещи инстанции, а връзките се разпределят между тях.
Клиент, който държи връзките си отворени и ги използва повторно (пул от keep-alive връзки), може да продължи да изпраща заявките си към една и съща инстанция; новите връзки се разпределят отново. Това е нормално и не изисква настройка.
Таймаути и повторни опити
По време на деплой или когато автоматичното мащабиране спре инстанция, заявка в процес на изпълнение може да се провали. Два навика правят извикванията между услугите надеждни:
- Кратък таймаут — няколко секунди, за да не виси извикването, докато инстанцията, към която е отишло, спира.
- Един или два повторни опита с кратка пауза за заявки, които е безопасно да се повторят — четене на данни с
GET. Не повтаряйте заявки, които променят данни (плащания, поръчки), освен ако API-то ви не може да различи повторена заявка от нова.
Пример: 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()Пример: Laravel
Поставете адреса в config/services.php:
'api' => [
'url' => env('RIVERVO_API_URL'),
],След това го четете с config(). В продукция конфигурацията се кешира и env(), извикана извън конфигурационните файлове, не връща нищо:
use Illuminate\Support\Facades\Http;
$orders = Http::timeout(5)
->retry(2, 200)
->get(config('services.api.url').'/orders')
->json();timeout(5) чака най-много 5 секунди; retry(2, 200) прави до 2 опита с 200 ms между тях.
Пример: Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()С повторни опити за 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()Неуспешна GET заявка — грешка при свързване или отговор 502, 503 или 504 — се повтаря до 2 пъти с кратка пауза, която нараства всеки път.
От командния ред и Rivervo MCP
rivervo appsи подробностите за услугата показват вътрешния адрес на всяка уеб услуга и дали тя има публичен адрес.rivervo services set-public <service> on|offпревключва публичния адрес. Изисква ролята Администратор и токен с Пълен достъп.- В Rivervo MCP същото превключване е инструментът
set_public_address.
Вижте Инструменти за разработчици за токени и командния ред.