Xizmatlararo aloqa: ichki manzillar va faqat ichki xizmatlar.
Bitta ilova xizmatlari bir-biriga ichki manzil orqali qanday murojaat qiladi, RIVERVO_<NAME>_URL oʻzgaruvchilari, ochiq manzilsiz xizmatlar, bir nechta instansiya, kutish vaqtlari va qayta urinishlar — Node.js, Laravel va Python uchun misollar bilan.
Bitta ilovaning xizmatlari bir-biri bilan internetni chetlab, toʻgʻridan-toʻgʻri muloqot qiladi. Sayt oʻz APIʼsiga, fon workeri ichki xizmatga murojaat qila oladi — va bu trafik bepul: u trafik sifatida hisoblanmaydi.
Quyidagi misollarda ikkita veb-xizmat ishlatiladi: web — tashrifchilar ochadigan sayt, Ochiq manzil bilan, va api — unga faqat web va boshqa xizmatlar murojaat qiladi, Faqat ichki rejimida.
Ichki manzil
Har bir veb-xizmatda — ochiq manzilli boʻlsin yoki faqat ichki — http://<service-name>:<port> koʻrinishidagi Ichki manzil bor, masalan, http://api:8080. U xizmat sahifasida va ilovaning Umumiy maʼlumot boʻlimida nusxalash tugmasi va «Bu ilovaning boshqa xizmatlari unga shu yerda murojaat qiladi — internetsiz, trafik uchun toʻlovsiz.» degan izoh bilan koʻrsatiladi.
- Repozitoriydan yigʻilgan xizmat uchun port 8080, tayyor obrazdan yaratilgan xizmat uchun esa siz belgilagan Port.
- Bu manzilga faqat shu ilovaning xizmatlari murojaat qila oladi. U internetdan ham, boshqa ilovalardan ham ochilmaydi.
- Manzil
http://dan foydalanadi. Ulanish ilova ichida qoladi, shuning uchun sertifikat sozlash shart emas.
Manzillar yozilgan oʻzgaruvchilar
Manzillarni kodingizga nusxalashingiz shart emas. Ilovaning har bir kodli xizmati — veb-xizmatlar, fon workerlari va rejalashtirilgan vazifalar — ilovaning boshqa har bir veb-xizmati ichki manzili yozilgan oʻzgaruvchini oladi:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME — xizmat nomi bosh harflar bilan, chiziqchalar _ ga almashtirilgan holda:
| Xizmat | Oʻzgaruvchi |
|---|---|
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 (tayyor obrazdan, port 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- Xizmat oʻzi uchun oʻzgaruvchi olmaydi.
- Maʼlumotlar bazalari va Valkeyʼda ulanish manzili yozilgan oʻz
RIVERVO_<NAME>_URLoʻzgaruvchisi saqlanib qoladi. Xizmat nomlari ilova ichida takrorlanmaydi, shuning uchun nomlar hech qachon toʻqnashmaydi. - Oʻzgaruvchilar Oʻzgaruvchilar boʻlimida Avtomatik oʻrnatiladi roʻyxatida koʻrsatiladi. Har qanday avtomatik oʻzgaruvchidagidek, xuddi shu nomli oʻz oʻzgaruvchingiz (yoki umumiy oʻzgaruvchi) uning oʻrnini egallaydi — Muhit oʻzgaruvchilari maqolasiga qarang.
- Oʻzgaruvchilar xizmatga keyingi deploy bilan yetib boradi. Yangi veb-xizmat qoʻshganingizda yoki uning nomini oʻzgartirganingizda, boshqa xizmatlar yangi yoki oʻzgargan oʻzgaruvchini keyingi deploy bilan oladi. Ular uni olishi uchun qayta deploy qiling, masalan,
rivervo deploy <app> --no-buildbilan — u ishlab turgan versiyani yangi oʻzgaruvchilar bilan, yangi yigʻishsiz qayta ishga tushiradi.
Faqat ichki xizmatlar
Ilovaning faqat boshqa xizmatlari murojaat qiladigan veb-xizmatga — saytingiz ortidagi API, admin backend, qidiruv tizimi — internetda boʻlish shart emas. Uni Faqat ichki rejimiga oʻtkazing:
| Ochiq manzil | Faqat ichki | |
|---|---|---|
Internetdagi https://<name>.rivervo.app manzili | ha | yoʻq |
| Oʻz domenlaringiz | ha | yoʻq |
| Branchlar uchun preview nusxalar | ha | yoʻq |
| Boshqa xizmatlar uchun ichki manzil | ha | ha |
| Bir nechta instansiya va avtomatik masshtablash, loglar, monitoring, holat tekshiruvlari | ha | ha |
Faqat ichki xizmat boshqa har qanday xizmat kabi ishlaydi; unga faqat shu ilovaning boshqa xizmatlari murojaat qila oladi.
Xizmat yaratishda tanlash
Veb-xizmat yaratayotganingizda — jumladan, yangi ilovaning birinchi xizmatini repozitoriydan, shablondan yoki tayyor obrazdan yaratganda ham — Ochiq manzil yoki Faqat ichki ni tanlang. Oldindan hech narsa tanlanmagan, shuning uchun tanlov doim sizda. Fon workerlari, rejalashtirilgan vazifalar va maʼlumotlar bazalarida hech qachon ochiq manzil boʻlmaydi, shuning uchun ular uchun tanlov yoʻq.
Bu tanlov paydo boʻlishidan oldin yaratilgan xizmatlar oʻz ochiq manzilini saqlab qoladi.
Keyinroq almashtirish
Xizmat → Sozlamalar → Ochiq manzil: almashtirgichni bosing va tasdiqlang. Buni faqat ilovaning Administratori yoki akkaunt egasi oʻzgartira oladi. Hech narsa qayta ishga tushmaydi.
- Xizmatga domenlar ulangan ekan, faqat ichki rejimga oʻtish rad etiladi — avval ularni xizmatning Domenlar boʻlimida olib tashlang. Preview nusxalarini ham avval oʻchirish kerak.
- Ochiq manzilni qayta yoqish xizmatga avvalgi
https://<name>.rivervo.appmanzilini qaytaradi. Sertifikat chiqishi taxminan bir daqiqa olishi mumkin. - Faqat ichki xizmatga domen qoʻshish rad etiladi — avval uning ochiq manzilini yoqing.
Terminal boʻlimi faqat ichki xizmatda ham boshqa xizmatlardagidek ishlaydi.
Asinxron aloqa
Yuqoridagi murojaatlar javobni kutadi. Agar xizmat ishni topshirib, oʻz ishini davom ettirishi kerak boʻlsa — fon vazifalari, bir nechta xizmat javob beradigan hodisalar — buning oʻrniga xabarlarni navbat yoki xabar brokeri orqali yuboring: Valkey, NATS yoki RabbitMQ. Hodisalar va navbatlar maqolasiga qarang.
Bir nechta instansiya
Siz murojaat qilayotgan xizmat bir nechta instansiyada ishlasa, uning ichki nomi barcha ishlab turgan instansiyalariga olib boradi va ulanishlar ular oʻrtasida taqsimlanadi.
Ulanishlarni ochiq ushlab, qayta ishlatadigan mijoz (keep-alive ulanishlar puli) soʻrovlarini bir xil instansiyaga yuborishda davom etishi mumkin; yangi ulanishlar esa yana taqsimlanadi. Bu odatiy holat va hech qanday sozlash talab qilmaydi.
Kutish vaqtlari va qayta urinishlar
Deploy paytida yoki avtomatik masshtablash instansiyani toʻxtatganda bajarilayotgan soʻrov muvaffaqiyatsiz tugashi mumkin. Xizmatlararo murojaatlarni ishonchli qiladigan ikki odat:
- Qisqa kutish vaqti — bir necha soniya, shunda murojaat yuborilgan instansiya toʻxtayotgan paytda u osilib qolmaydi.
- Takrorlash xavfsiz boʻlgan soʻrovlar —
GETbilan maʼlumot oʻqish — uchun qisqa pauza bilan bir yoki ikki qayta urinish. Agar APIʼngiz takroriy soʻrovni yangisidan ajrata olmasa, maʼlumotni oʻzgartiradigan soʻrovlarni (toʻlovlar, buyurtmalar) takrorlamang.
Misol: 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()Misol: Laravel
Manzilni config/services.php ga yozing:
'api' => [
'url' => env('RIVERVO_API_URL'),
],Soʻng uni config() bilan oʻqing. Productionda konfiguratsiya keshlanadi va konfiguratsiya fayllaridan tashqarida chaqirilgan env() hech narsa qaytarmaydi:
use Illuminate\Support\Facades\Http;
$orders = Http::timeout(5)
->retry(2, 200)
->get(config('services.api.url').'/orders')
->json();timeout(5) koʻpi bilan 5 soniya kutadi; retry(2, 200) oraligʻi 200 ms boʻlgan 2 tagacha urinish qiladi.
Misol: Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()GET uchun qayta urinishlar bilan:
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()Muvaffaqiyatsiz GET — ulanish xatosi yoki 502, 503 yoki 504 javobi — har safar uzayib boradigan qisqa pauza bilan 2 martagacha takrorlanadi.
Buyruq qatori va Rivervo MCP orqali
rivervo appsva xizmat tafsilotlari har bir veb-xizmatning ichki manzilini va uning ochiq manzili bor-yoʻqligini koʻrsatadi.rivervo services set-public <service> on|offochiq manzilni yoqadi yoki oʻchiradi. Buning uchun Administrator roli va Toʻliq kirish huquqli token kerak.- Rivervo MCP da xuddi shu almashtirgich —
set_public_addressvositasi.
Tokenlar va buyruq qatori haqida Dasturchi vositalari maqolasiga qarang.