सर्विसों के बीच संचार: इंटरनल पते और सिर्फ़ इंटरनल सर्विसें।
एक ऐप्लिकेशन की सर्विसें इंटरनल पते पर एक-दूसरे तक कैसे पहुँचती हैं, RIVERVO_<NAME>_URL वेरिएबल, बिना पब्लिक पते वाली सर्विसें, कई इंस्टेंस, और Node.js, Laravel और Python के उदाहरणों के साथ टाइमआउट और रीट्राई।
एक ऐप्लिकेशन की सर्विसें इंटरनेट से गुज़रे बिना सीधे एक-दूसरे से बात करती हैं। साइट अपने API को कॉल कर सकती है, वर्कर किसी इंटरनल सर्विस को कॉल कर सकता है — और यह ट्रैफ़िक फ़्री है: इसे ट्रैफ़िक में नहीं गिना जाता।
नीचे के उदाहरणों में दो वेब सर्विसें हैं: web, वह साइट जिसे विज़िटर खोलते हैं, पब्लिक पते के साथ, और api, जिसे सिर्फ़ web और दूसरी सर्विसें कॉल करती हैं, सिर्फ़ इंटरनल पर सेट।
इंटरनल पता
हर वेब सर्विस — पब्लिक पते वाली हो या सिर्फ़ इंटरनल — का एक इंटरनल पता होता है, http://<service-name>:<port> के रूप में, जैसे http://api:8080। यह सर्विस के पेज पर और ऐप्लिकेशन के ओवरव्यू पर दिखता है, कॉपी बटन और संकेत «इस ऐप्लिकेशन की दूसरी सर्विसें इसे यहाँ पाती हैं — बिना इंटरनेट, बिना ट्रैफ़िक चार्ज के।» के साथ।
- रिपॉज़िटरी से बनी सर्विस के लिए पोर्ट 8080 है, या तैयार इमेज वाली सर्विस के लिए आपका सेट किया गया पोर्ट।
- इस पते तक सिर्फ़ उसी ऐप्लिकेशन की सर्विसें पहुँच सकती हैं। यह इंटरनेट से या दूसरे ऐप्लिकेशन से नहीं खुलता।
- पता
http://इस्तेमाल करता है। कनेक्शन ऐप्लिकेशन के अंदर ही रहता है, इसलिए कोई सर्टिफ़िकेट सेट नहीं करना पड़ता।
पतों वाले वेरिएबल
आपको पते अपने कोड में कॉपी करने की ज़रूरत नहीं। ऐप्लिकेशन की हर कोड सर्विस — वेब सर्विसें, बैकग्राउंड वर्कर और शेड्यूल्ड जॉब — को ऐप्लिकेशन की हर दूसरी वेब सर्विस के इंटरनल पते वाला एक वेरिएबल मिलता है:
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कनेक्शन पते के साथ रखते हैं। सर्विस के नाम एक ऐप्लिकेशन में यूनिक होते हैं, इसलिए नाम कभी टकराते नहीं। - ये वेरिएबल वेरिएबल टैब पर अपने-आप सेट वाले वेरिएबल में दिखते हैं। हर ऑटोमैटिक वेरिएबल की तरह, उसी नाम का आपका अपना वेरिएबल (या शेयर्ड वेरिएबल) उसकी जगह ले लेता है — देखें एनवायरनमेंट वेरिएबल।
- वेरिएबल किसी सर्विस तक उसके अगले डिप्लॉय के साथ पहुँचते हैं। जब आप नई वेब सर्विस जोड़ते हैं या किसी का नाम बदलते हैं, तो दूसरी सर्विसों को नया या बदला हुआ वेरिएबल उनके अगले डिप्लॉय पर मिलता है। उन्हें दोबारा डिप्लॉय करें ताकि वे इसे ले लें, जैसे
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) उनके बीच 200 ms के अंतर से ज़्यादा से ज़्यादा 2 कोशिशें करता है।
उदाहरण: 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टूल है।
टोकन और कमांड लाइन के लिए डेवलपर टूल देखें।