Започнете

Комуникация между услугите: вътрешни адреси и само вътрешни услуги.

Как услугите на едно приложение се достигат една друга по вътрешния адрес, променливите RIVERVO_<NAME>_URL, услуги без публичен адрес, няколко инстанции, таймаути и повторни опити с примери за Node.js, Laravel и Python.

6 МИН. ЧЕТЕНЕ

Услугите на едно приложение комуникират помежду си директно, без да минават през интернет. Сайтът може да извиква собствения си 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 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.

Вижте Инструменти за разработчици за токени и командния ред.

Още имате въпроси?

Пишете ни в чата — AI отговаря веднага, а инженер се включва, когато е нужно, по всяко време на денонощието.

Връзка с поддръжката