Почати

Взаємодія сервісів: внутрішні адреси й сервіси лише для внутрішнього доступу.

Як сервіси одного застосунку звертаються один до одного за внутрішньою адресою, змінні RIVERVO_<NAME>_URL, сервіси без публічної адреси, кілька екземплярів, тайм-аути й повторні спроби з прикладами для Node.js, Laravel і Python.

5 ХВ ЧИТАННЯ

Сервіси одного застосунку спілкуються між собою напряму, оминаючи інтернет. Сайт може звертатися до власного API, фоновий процес — до внутрішнього сервісу, і цей трафік безкоштовний: він не враховується як трафік.

У прикладах нижче два вебсервіси: web — сайт, який відкривають відвідувачі, з Публічною адресою, і api, до якого звертаються лише web та інші сервіси, з налаштуванням Лише внутрішній.

Внутрішня адреса

Кожен вебсервіс — і з публічною адресою, і лише внутрішній — має Внутрішню адресу у форматі http://<service-name>:<port>, наприклад http://api:8080. Її показано на сторінці сервісу й на сторінці Огляд застосунку, з кнопкою копіювання та підказкою «Інші сервіси цього застосунку звертаються до нього за цією адресою — без інтернету й без плати за трафік.»

  • Порт — 8080 для сервісу, зібраного з репозиторію, або Порт, який ви вказали для сервісу з готового образу.
  • Ця адреса доступна лише сервісам того самого застосунку. З інтернету чи з інших застосунків вона не відкривається.
  • Адреса використовує http://. З’єднання не виходить за межі застосунку, тож сертифікат налаштовувати не потрібно.

Змінні з адресами

Копіювати адреси у свій код не потрібно. Кожен сервіс застосунку з кодом — вебсервіси, фонові процеси й завдання за розкладом — отримує змінну з внутрішньою адресою кожного іншого вебсервісу застосунку:

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

NAME — назва сервісу великими літерами, дефіси замінено на _:

СервісЗмінна
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_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.

Про токени й командний рядок читайте в статті Інструменти розробника.

Залишилися питання?

Напишіть нам у чат — AI відповідає одразу, а інженер підключається за потреби в будь-який час доби.

Написати в підтримку