დაწყება

სერვისებს შორის კავშირი: შიდა მისამართები და მხოლოდ შიდა სერვისები.

როგორ უკავშირდებიან ერთი აპლიკაციის სერვისები ერთმანეთს შიდა მისამართით, 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 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 მაშინვე გპასუხობთ, საჭიროებისას კი ინჟინერი უერთდება, დღე-ღამის ნებისმიერ დროს.

მხარდაჭერასთან დაკავშირება