Қызметтер арасындағы байланыс: ішкі мекенжайлар және тек ішкі қызметтер.
Бір қолданбаның қызметтері бір-біріне ішкі мекенжай арқылы қалай жүгінеді, RIVERVO_<NAME>_URL айнымалылары, жария мекенжайы жоқ қызметтер, бірнеше дана, сондай-ақ тайм-ауттар мен қайталаулар — Node.js, Laravel және Python мысалдарымен.
Бір қолданбаның қызметтері бір-бірімен интернетті айналып өтпей, тікелей байланысады. Сайт өз API-іне, воркер ішкі қызметке жүгіне алады — және бұл трафик тегін: ол трафик ретінде есептелмейді.
Төмендегі мысалдарда екі веб-қызмет бар: келушілер ашатын, Жария мекенжайы бар web сайты және оған тек web пен басқа қызметтер жүгінетін, Тек ішкі режиміндегі api.
Ішкі мекенжай
Әр веб-қызметтің — жария мекенжайы бар болсын, тек ішкі болсын — 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() арқылы оқыңыз. Production ортасында конфигурация кэштеледі, ал конфигурация файлдарынан тыс шақырылған 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) арасында 200 мс үзіліспен 2 әрекетке дейін жасайды.
Мысал: 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құралы.
Токендер мен командалық жол туралы Әзірлеуші құралдары мақаласын қараңыз.