प्रोजेक्ट की सर्विसें: वेब सर्विसें, वर्कर और शेड्यूल्ड जॉब।
प्रोजेक्ट में बैकग्राउंड वर्कर, शेड्यूल्ड जॉब, और वेब सर्विसें, डेटाबेस और Valkey जोड़ें — उसके अपने कोड से, किसी दूसरी रिपॉज़िटरी से या तैयार इमेज से — नाम से पहुँचने योग्य और एक ही बिल में।
एक प्रोजेक्ट सिर्फ़ एक प्रोसेस नहीं होता। मुख्य ऐप्लिकेशन के साथ आप क्यू वर्कर, रात का जॉब, अलग API, डेटाबेस चला सकते हैं — हर एक को अपने रिसोर्स वाली सर्विस के रूप में, सब एक ही बिल में।
सर्विसें ऐप्लिकेशन के ओवरव्यू → सर्विसें → सर्विस जोड़ें में दिखती हैं। एक प्रोजेक्ट में ज़्यादा से ज़्यादा 10 सर्विसें हो सकती हैं। मुख्य सर्विस पहले लॉन्च होनी चाहिए, और प्रोजेक्ट का सब्सक्रिप्शन चालू होना चाहिए (ट्रायल भी गिना जाता है)।
सर्विसों के प्रकार
| प्रकार | यह क्या है |
|---|---|
| वेब सर्विस | एक और साइट या API — पब्लिक पते के साथ या सिर्फ़ इंटरनल |
| बैकग्राउंड वर्कर | हमेशा चलता है: क्यू, Horizon, Celery, कंज़्यूमर |
| शेड्यूल्ड जॉब | शेड्यूल पर शुरू होता है (cron फ़ॉर्मेट, UTC), अपना काम करता है और रुक जाता है |
| PostgreSQL, MySQL, Valkey | मैनेज्ड डेटाबेस — देखें डेटाबेस |
| NATS, RabbitMQ | इवेंट और क्यू के लिए मैसेज ब्रोकर, सिर्फ़ इंटरनल — देखें इवेंट और क्यू |
पब्लिक पता या सिर्फ़ इंटरनल
वेब सर्विस जोड़ते समय चुनें कि उस तक कैसे पहुँचा जा सकता है — पहले से कुछ भी चुना नहीं होता:
- पब्लिक पता — इंटरनेट से
https://<name>.rivervo.appपर खुलती है; इसमें आपके अपने डोमेन हो सकते हैं। - सिर्फ़ इंटरनल — इंटरनेट पर कोई पता नहीं और कोई डोमेन नहीं; सिर्फ़ ऐप्लिकेशन की दूसरी सर्विसें इस तक पहुँचती हैं। आपकी साइट के पीछे के API, एडमिन बैकएंड या सर्च इंजन के लिए सही।
बैकग्राउंड वर्कर, शेड्यूल्ड जॉब और डेटाबेस कभी पब्लिक नहीं होते, इसलिए उनके लिए कोई विकल्प नहीं है। आप इसे बाद में सर्विस की सेटिंग्स → पब्लिक पता में बदल सकते हैं — देखें सर्विसों के बीच संचार।
कोड कहाँ से आता है
इसी प्रोजेक्ट का कोड
वही कोड, दूसरे तरीके से शुरू किया गया: क्यू वर्कर, शेड्यूलर, WebSocket सर्वर (जैसे Laravel Reverb), मोनोरेपो का कोई फ़ोल्डर, अलग API।
- कमांड ज़रूरी है — सर्विस क्या चलाती है, जैसे
php artisan queue:workयाnode worker.js। - वेब सर्विस को
$PORTवाले पोर्ट पर सुनना चाहिए। - शेड्यूल्ड जॉब को cron फ़ॉर्मेट (UTC) में शेड्यूल भी चाहिए, जैसे
*/5 * * * *। - मुख्य सर्विस का हर नया वर्शन इन सर्विसों पर भी डिप्लॉय होता है, ताकि वे हमेशा एक ही कोड चलाएँ।
दूसरी रिपॉज़िटरी
आपके कनेक्ट किए गए Git अकाउंट की किसी दूसरी रिपॉज़िटरी से वेब सर्विस या बैकग्राउंड वर्कर, अपनी ब्रांच के साथ और ज़रूरत हो तो प्रोजेक्ट फ़ोल्डर और बिल्ड और स्टार्ट कमांड के साथ (हमारी पहचानी गई चीज़ इस्तेमाल करने के लिए फ़ील्ड खाली छोड़ें)। इसके अपने डिप्लॉय और वर्शन होते हैं और यह अपनी ब्रांच पर हर पुश को डिप्लॉय करती है। सर्विसों के लिए ब्रांच प्रीव्यू अभी नहीं बनते।
तैयार इमेज
Docker Hub, GitHub Container Registry या किसी दूसरी रजिस्ट्री पर तैयार इमेज (Docker इमेज) से वेब सर्विस या बैकग्राउंड वर्कर — जैसे nginx:1.27 या ghcr.io/org/app:tag।
- पोर्ट — वह पोर्ट जिस पर इमेज सुनती है; हम इसे
$PORTमें भी देते हैं। - कमांड — वैकल्पिक; खाली होने पर इमेज वैसे ही शुरू होती है जैसे वह बनी है।
- प्राइवेट रजिस्ट्री — यूज़र नेम और पासवर्ड या एक्सेस टोकन। ये एन्क्रिप्ट करके रखे जाते हैं, सिर्फ़ इमेज डाउनलोड करने के लिए इस्तेमाल होते हैं और फिर कभी नहीं दिखाए जाते।
- ऑटोमैटिक डिप्लॉय चालू होने पर हम दिन में एक बार जाँचते हैं कि टैग किसी नए वर्शन की ओर इशारा करता है या नहीं, और उसे डिप्लॉय करते हैं। डिप्लॉय टैब पर इमेज फिर से डाउनलोड करें यह तुरंत करता है।
Kafka (टेम्पलेट)
सर्विस जोड़ें में Kafka एक-क्लिक प्रीसेट है: यह आधिकारिक Apache Kafka इमेज (3.9) से एक सर्विस बनाता है — KRaft मोड में एक ब्रोकर, ZooKeeper के बिना। यह डेवलपमेंट और मध्यम लोड के लिए सही है।
- सिर्फ़ इंटरनल — कोई पब्लिक पता नहीं और बाहर से कोई एक्सेस नहीं; सिर्फ़ ऐप्लिकेशन की सर्विसें इस तक पहुँचती हैं।
- ऐप्लिकेशन की दूसरी कोड सर्विसों को
KAFKA_BROKERS=<service name>:9092औरRIVERVO_<NAME>_URL=<service name>:9092मिलते हैं। - टॉपिक पहली बार इस्तेमाल होने पर अपने-आप बन जाते हैं।
- यह 1 GB मेमोरी · 1 CPU कोर · 10 GB डिस्क से शुरू होता है। तैयार इमेज वाली किसी भी सर्विस की तरह, आप इसके रिसोर्स और वेरिएबल बदल सकते हैं।
- इसका डेटा उसकी डिस्क पर सर्विस के डेटा फ़ोल्डर में रखा जाता है।
इसमें क्या नहीं है:
- एक ब्रोकर — कोई रेप्लिकेशन नहीं; हर टॉपिक का रेप्लिकेशन फ़ैक्टर 1 है।
- मैनेज्ड Kafka बैकअप नहीं। रोज़ाना बैकअप Kafka के चलते हुए उसके डेटा फ़ोल्डर को फ़ाइलों के रूप में कॉपी करता है। यह Kafka का सुसंगत बैकअप नहीं है: रीस्टोर के बाद हाल के मैसेज गायब हो सकते हैं, या शुरू होने पर Kafka को अपने लॉग रिकवर करने पड़ सकते हैं।
- न मेंटेनेंस का समय, न बाहर से एक्सेस और न Kafka UI।
- Kafka को अपग्रेड करना आपकी ज़िम्मेदारी है: सर्विस की सेटिंग्स में इमेज बदलें।
बैकअप और आपके लिए सेट किए गए कनेक्शन वेरिएबल वाली क्यू और इवेंट के लिए देखें इवेंट और क्यू — NATS और RabbitMQ।
नाम से एक-दूसरे तक पहुँचना
प्रोजेक्ट की सर्विसें प्राइवेट नेटवर्क पर नाम से बात करती हैं: api नाम की सर्विस दूसरों से api के रूप में मिलती है, db नाम का डेटाबेस db के रूप में, और मुख्य सर्विस web के रूप में। प्रोजेक्ट की सर्विसों के बीच का ट्रैफ़िक ट्रैफ़िक में नहीं गिना जाता।
हर वेब सर्विस अपना इंटरनल पता दिखाती है — जैसे http://api:8080 — और दूसरी सर्विसों को यह एक वेरिएबल RIVERVO_API_URL में मिलता है। यह कैसे काम करता है, सिर्फ़ इंटरनल सर्विसें, कई इंस्टेंस और टाइमआउट: सर्विसों के बीच संचार।
हर सर्विस को प्रोजेक्ट के वेरिएबल मिलते हैं — डेटाबेस कनेक्शन सहित — और साथ में उसके अपने वेरिएबल, जो प्रोजेक्ट वालों से ऊपर माने जाते हैं। देखें एनवायरनमेंट वेरिएबल।
रिसोर्स और कीमत
हर सर्विस की अपनी मेमोरी, CPU और डिस्क होती है, जिनकी कीमत किसी भी ऐप्लिकेशन की तरह है: मेमोरी के लिए ₹661.83 प्रति GB और ₹441.21 प्रति CPU कोर हर महीने, मेमोरी के हर GB पर 10 GB डिस्क शामिल, उसके बाद ₹16.54 प्रति GB। एक सर्विस में ज़्यादा से ज़्यादा 8 GB मेमोरी हो सकती है।
जब आप सर्विस जोड़ते हैं, तो उसकी कीमत प्रोजेक्ट के बिल में जुड़ जाती है — चालू महीने के लिए सिर्फ़ उसका बचा हुआ हिस्सा। जब तक प्रोजेक्ट फ़्री ट्रायल पर है, नई सर्विसें ट्रायल ख़त्म होने तक फ़्री हैं।
ओवरव्यू में प्रोजेक्ट कुल दिखता है — प्रोजेक्ट की सभी सर्विसों की एक महीने की कुल कीमत।
ऐप्लिकेशन के अंदर ही वर्कर
आपको हमेशा अलग सर्विस की ज़रूरत नहीं होती। मुख्य ऐप्लिकेशन के प्रोसेस टैब में ये हैं:
- बैकग्राउंड वर्कर — साइट के साथ ज़्यादा से ज़्यादा 5 लगातार चलने वाले प्रोसेस, जैसे क्यू वर्कर। ये ऐप्लिकेशन के रिसोर्स साझा करते हैं और हर डिप्लॉय के साथ रीस्टार्ट होते हैं।
- शेड्यूल्ड कमांड — शेड्यूल पर ज़्यादा से ज़्यादा 10 कमांड (cron फ़ॉर्मेट, UTC)। इनका आउटपुट लॉग में शेड्यूल के तहत होता है।
- कंसोल — चल रहे ऐप्लिकेशन के अंदर उसके वेरिएबल और डेटाबेस के साथ एक बार की कमांड चलाएँ। कमांड ज़्यादा से ज़्यादा 15 मिनट चल सकती है; इंटरैक्टिव कमांड (tinker, शेल) यहाँ सपोर्ट नहीं होतीं।
अलग सर्विस तब बेहतर विकल्प है जब वर्कर को अपने रिसोर्स चाहिए, ताकि भारी क्यू कभी साइट को धीमा न करे।
सर्विस बदलना
सर्विसें सूची से सर्विस खोलें। उसकी सेटिंग्स में कमांड, शेड्यूल, इमेज या ब्रांच, और उसके रिसोर्स होते हैं; बदलाव सेव होते हैं और सर्विस उनके साथ रीस्टार्ट होती है। हर सर्विस के अपने लॉग और मॉनिटरिंग भी होते हैं।