תקשורת בין שירותים: כתובות פנימיות ושירותים פנימיים בלבד.
איך שירותים של אפליקציה אחת מגיעים זה לזה דרך הכתובת הפנימית, משתני RIVERVO_<NAME>_URL, שירותים בלי כתובת ציבורית, כמה מופעים, ו-timeouts וניסיונות חוזרים עם דוגמאות ל-Node.js, Laravel ו-Python.
שירותים של אפליקציה אחת מתקשרים זה עם זה ישירות, בלי לעבור דרך האינטרנט. אתר יכול לפנות ל-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 הוא שם השירות באותיות גדולות, כשמקפים הופכים ל-_:
| שירות | משתנה |
|---|---|
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משלהם עם כתובת החיבור. שמות השירותים ייחודיים בתוך אפליקציה, כך שהשמות אף פעם לא מתנגשים. - המשתנים מופיעים בלשונית משתנים בין המשתנים שמוגדרים אוטומטית. כמו בכל משתנה אוטומטי, משתנה משלכם (או משתנה משותף) באותו שם תופס את מקומו — ראו משתני סביבה.
- המשתנים מגיעים לשירות בפריסה הבאה שלו. כשמוסיפים שירות 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.
ראו כלים למפתחים על טוקנים ושורת הפקודה.