Взаємодія сервісів: внутрішні адреси й сервіси лише для внутрішнього доступу.
Як сервіси одного застосунку звертаються один до одного за внутрішньою адресою, змінні 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 мс між ними.
Приклад: 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.
Про токени й командний рядок читайте в статті Інструменти розробника.