Boshlash

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.

5 DAQIQA OʻQISH

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:

XizmatOʻzgaruvchi
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_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>_URL oʻ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-build bilan — 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 manzilFaqat ichki
Internetdagi https://<name>.rivervo.app manzilihayoʻq
Oʻz domenlaringizhayoʻq
Branchlar uchun preview nusxalarhayoʻq
Boshqa xizmatlar uchun ichki manzilhaha
Bir nechta instansiya va avtomatik masshtablash, loglar, monitoring, holat tekshiruvlarihaha

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.app manzilini 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 — GET bilan 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 apps va xizmat tafsilotlari har bir veb-xizmatning ichki manzilini va uning ochiq manzili bor-yoʻqligini koʻrsatadi.
  • rivervo services set-public <service> on|off ochiq manzilni yoqadi yoki oʻchiradi. Buning uchun Administrator roli va Toʻliq kirish huquqli token kerak.
  • Rivervo MCP da xuddi shu almashtirgich — set_public_address vositasi.

Tokenlar va buyruq qatori haqida Dasturchi vositalari maqolasiga qarang.

Hali ham savollar bormi?

Bizga chatda yozing — AI darhol javob beradi, kerak boʻlsa muhandis qoʻshiladi, kunning istalgan vaqtida.

Yordamga yozish