להתחיל

תקשורת בין שירותים: כתובות פנימיות ושירותים פנימיים בלבד.

איך שירותים של אפליקציה אחת מגיעים זה לזה דרך הכתובת הפנימית, משתני RIVERVO_<NAME>_URL, שירותים בלי כתובת ציבורית, כמה מופעים, ו-timeouts וניסיונות חוזרים עם דוגמאות ל-Node.js, ‏Laravel ו-Python.

5 דקות קריאה

שירותים של אפליקציה אחת מתקשרים זה עם זה ישירות, בלי לעבור דרך האינטרנט. אתר יכול לפנות ל-API שלו, worker יכול לפנות לשירות פנימי — והתעבורה הזו בחינם: היא לא נספרת כתעבורה.

הדוגמאות בהמשך משתמשות בשני שירותי web: ‏web, האתר שהמבקרים פותחים, עם כתובת ציבורית, ו-api, שרק web והשירותים האחרים פונים אליו, מוגדר כפנימי בלבד.

הכתובת הפנימית

לכל שירות web — עם כתובת ציבורית או פנימי בלבד — יש כתובת פנימית בתבנית http://<service-name>:<port>, למשל http://api:8080. היא מוצגת בעמוד של השירות ובסקירה כללית של האפליקציה, עם כפתור העתקה וההסבר «השירותים האחרים של האפליקציה מגיעים אליו כאן — בלי אינטרנט ובלי חיוב על תעבורה.»

  • הפורט הוא 8080 לשירות שנבנה ממאגר, או הפורט שהגדרתם לשירות מאימג׳ מוכן.
  • רק השירותים של אותה אפליקציה יכולים להגיע לכתובת הזו. היא לא נפתחת מהאינטרנט או מאפליקציות אחרות.
  • הכתובת משתמשת ב-http://. החיבור נשאר בתוך האפליקציה, כך שאין תעודה להגדיר.

משתנים עם הכתובות

לא צריך להעתיק את הכתובות לקוד. כל שירות קוד של האפליקציה — שירותי web, ‏workers ברקע ומשימות מתוזמנות — מקבל משתנה עם הכתובת הפנימית של כל שירות web אחר באפליקציה:

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 משלהם עם כתובת החיבור. שמות השירותים ייחודיים בתוך אפליקציה, כך שהשמות אף פעם לא מתנגשים.
  • המשתנים מופיעים בלשונית משתנים בין המשתנים שמוגדרים אוטומטית. כמו בכל משתנה אוטומטי, משתנה משלכם (או משתנה משותף) באותו שם תופס את מקומו — ראו משתני סביבה.
  • המשתנים מגיעים לשירות בפריסה הבאה שלו. כשמוסיפים שירות web חדש או משנים שם של שירות, השירותים האחרים מקבלים את המשתנה החדש או המעודכן בפריסה הבאה שלהם. פרסו אותם מחדש כדי שיקלטו אותו, למשל עם rivervo deploy <app> --no-build — זה מפעיל מחדש את הגרסה הרצה עם המשתנים החדשים, בלי בנייה חדשה.

שירותים פנימיים בלבד

שירות web שרק שירותים אחרים של האפליקציה פונים אליו — API שמאחורי האתר, backend של ניהול, מנוע חיפוש — לא צריך להיות באינטרנט. הגדירו אותו כפנימי בלבד:

כתובת ציבוריתפנימי בלבד
כתובת באינטרנט https://<name>.rivervo.appכןלא
דומיינים משלכםכןלא
תצוגות מקדימות של branchesכןלא
כתובת פנימית לשירותים האחריםכןכן
כמה מופעים והתאמת היקף אוטומטית, לוגים, ניטור, בדיקות תקינותכןכן

שירות פנימי בלבד רץ כמו כל שירות אחר; רק השירותים האחרים של אותה אפליקציה יכולים להגיע אליו.

בחירה ביצירת שירות

כשיוצרים שירות web — כולל השירות הראשון של אפליקציה חדשה, ממאגר, מתבנית או מאימג׳ מוכן — בוחרים כתובת ציבורית או פנימי בלבד. שום דבר לא נבחר מראש, כך שהבחירה תמיד שלכם. ל-workers ברקע, למשימות מתוזמנות ולמסדי נתונים אף פעם אין כתובת ציבורית, ולכן אין בהם בחירה.

שירותים שנוצרו לפני שהבחירה הזו נוספה שומרים על הכתובת הציבורית שלהם.

שינוי בהמשך

השירות → הגדרות → כתובת ציבורית: העבירו את המתג ואשרו. רק מנהל של האפליקציה או בעל החשבון יכולים לשנות את זה. שום דבר לא מופעל מחדש.

  • מעבר לפנימי בלבד נדחה כל עוד מחוברים לשירות דומיינים — הסירו אותם קודם בלשונית דומיינים שלו. גם תצוגות מקדימות צריך לכבות קודם.
  • הפעלה מחדש של הכתובת הציבורית מחזירה לשירות את אותה כתובת https://<name>.rivervo.app. התעודה עשויה לקחת בערך דקה.
  • הוספת דומיין לשירות פנימי בלבד נדחית — הפעילו קודם את הכתובת הציבורית שלו.

הלשונית טרמינל עובדת בשירות פנימי בלבד בדיוק כמו בכל שירות אחר.

תקשורת אסינכרונית

הקריאות שלמעלה מחכות לתשובה. כששירות צריך להעביר עבודה ולהמשיך הלאה — משימות ברקע, אירועים שכמה שירותים מגיבים להם — שלחו הודעות דרך תור או ברוקר הודעות במקום: Valkey, ‏NATS או RabbitMQ. ראו אירועים ותורים.

כמה מופעים

כשהשירות שאליו פונים מריץ כמה מופעים, השם הפנימי שלו מוביל לכל המופעים הרצים שלו, והחיבורים מתפזרים ביניהם.

לקוח ששומר את החיבורים שלו פתוחים ומשתמש בהם שוב (מאגר חיבורי keep-alive) עשוי להמשיך לשלוח את הבקשות לאותו מופע; חיבורים חדשים מתפזרים מחדש. זה תקין ולא דורש שום הגדרה.

Timeouts וניסיונות חוזרים

במהלך פריסה, או כשהתאמת ההיקף האוטומטית עוצרת מופע, בקשה שנמצאת בתהליך עלולה להיכשל. שני הרגלים הופכים את הקריאות בין שירותים לאמינות:

  • Timeout קצר — כמה שניות, כדי שקריאה אף פעם לא תיתקע בזמן שהמופע שאליו היא נשלחה נעצר.
  • ניסיון חוזר אחד או שניים עם הפסקה קצרה, לבקשות שבטוח לחזור עליהן — קריאת נתונים עם 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) מבצע עד 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 ופרטי השירות מציגים את הכתובת הפנימית של כל שירות web והאם יש לו כתובת ציבורית.
  • rivervo services set-public <service> on|off מחליף את מצב הכתובת הציבורית. נדרשים תפקיד מנהל וטוקן עם גישה מלאה.
  • ב-Rivervo MCP אותו מתג הוא הכלי set_public_address.

ראו כלים למפתחים על טוקנים ושורת הפקודה.

עדיין תקועים?

דברו איתנו בצ׳אט — AI עונה מיד, ומהנדס מצטרף כשצריך, בכל שעה ביממה.

פנייה לתמיכה