सामग्री पर जाएँ
ऑराबेस लोगो
aurabase

वास्तुकला

एक अनुरोध आपके क्लाइंट से Postgres तक कैसे जाता है, कैसे संगठन और परियोजनाएं अलग-थलग होती हैं, और सेवाएं कैसे मापी जाती हैं।

व्याख्या7 मि॰ पढ़ेंस्तर मध्यवर्ती4 नव॰ 2026 पर संशोधित

यह पृष्ठ स्वचालित रूप से अनुवादित किया गया था. अंग्रेजी संस्करण प्रामाणिक है.

एक बैकएंड, आठ सेवाएँ#

Aurabase एक Rust मोनोरेपो है जो आठ एक्सम सेवाएं बनाता है। प्रत्येक सेवा का अपना पोर्ट और अपना /v1/<service>/… मार्ग होता है, और सेवाएँ NATS अनुरोध/उत्तर पर एक-दूसरे से बात करती हैं। आपके एप्लिकेशन का सारा ट्रैफ़िक एक गेटवे से होकर जाता है।

कोई सेवा अपने आप पुनरारंभ हो सकती है, क्रैश हो सकती है या तैनात हो सकती है। गेटवे एक सर्किट ब्रेकर के साथ प्रत्येक सेवा के स्वास्थ्य को ट्रैक करता है: 60 सेकंड के भीतर 5 विफलताओं के बाद, यह 30 सेकंड के लिए उस सेवा के लिए 503 का उत्तर देता है, फिर दोबारा कोशिश करता है।

सेवाएँ और जिम्मेदारियाँ#

प्रत्येक सेवा के पास एक डोमेन, अपना स्वयं का SQL माइग्रेशन और अपना डेटा होता है। आपके आवेदन गेटवे के माध्यम से ही उन तक पहुंचते हैं।

सेवाकार्यक्षेत्रजिम्मेदारियों
aura-gatewayएपीआई गेटवेप्रॉक्सी, प्रमाणीकरण मिडलवेयर, दर सीमित करना, सर्किट ब्रेकर
aura-authप्रमाणीकरणसाइन-अप, साइन-इन, OAuth 2.1, TOTP MFA और WebAuthn, सत्र, JWKS
aura-dbडेटाबेसPostgREST पर CRUD, संस्करणित माइग्रेशन, प्रकार निर्माण, स्कीमा प्रबंधन
aura-realtimeरियल टाइमवेबसॉकेट, एसएसई, इवेंट रिले, उपस्थिति, Postgres डेटा कैप्चर बदलें
aura-storageभंडारणS3-संगत ऑब्जेक्ट भंडारण, मल्टीपार्ट अपलोड, हस्ताक्षरित यूआरएल, छवि परिवर्तन
aura-functionsEdge FunctionsWASM और Deno रनटाइम, क्रॉन, एसिंक्रोनस जॉब कतार, डेड-लेटर कतार
aura-notificationsसूचनाएंट्रांजेक्शनल ईमेल (एसएमटीपी), एसएमएस, मोबाइल पुश, HMAC-हस्ताक्षरित वेबहुक
aura-aiएआई गेटवेएक समापन बिंदु के माध्यम से एलएलएम अनुमान, एम्बेडिंग, आरएजी pgvector के साथ

संगठन और परियोजना द्वारा अलगाव#

प्रत्येक संगठन को अपना स्वयं का PostgreSQL क्लस्टर मिलता है, जो उसके लिए आरक्षित Kubernetes नेमस्पेस में CloudNativePG (CNPG) के साथ प्रावधानित होता है। दो संगठनों के बीच कोई क्लस्टर, नेमस्पेस या कनेक्शन पूल साझा नहीं किया जाता है। क्लस्टर की क्षमता (vCPU, मेमोरी, प्रतिकृतियां) संगठन की योजना का पालन करती है।

उस क्लस्टर के अंदर, प्रत्येक प्रोजेक्ट को अपना Postgres डेटाबेस मिलता है, जो चार स्कीमा में विभाजित होता है। प्रत्येक प्रोजेक्ट की अपनी कनेक्शन भूमिका होती है, जो केवल अपनी भूमिकाओं का सदस्य होता है। किसी प्रोजेक्ट के स्कीमा पर अधिकार उन भूमिकाओं को दिए जाते हैं, न कि PUBLIC को। गेटवे क्लाइंट के JWT में प्रोजेक्ट से कनेक्शन search_path सेट करता है, और एप्लिकेशन टेबल पंक्ति-स्तरीय सुरक्षा (RLS) द्वारा संरक्षित होते हैं।

एंटरप्राइज़ ऑफर पर, एक प्रोजेक्ट को अपने नामस्थान में एक समर्पित CNPG क्लस्टर भी मिल सकता है। अलगाव तब अनुमतियों के अलावा, समूहों के भौतिक पृथक्करण से आता है।

योजनामालिकसामग्री
project_{uuid}आपआपकी एप्लिकेशन तालिकाएँ
project_{uuid}_authaura-authusers, sessions, oauth_accounts, mfa
project_{uuid}_storageaura-storagebuckets, objects, rls_policies
project_{uuid}_platformप्लैटफ़ॉर्मfunctions, jobs, cron, api_keys, webhooks

तीन परिणाम इस प्रकार हैं:

  • कोई क्रॉस-टेनेंट पहुंच नहीं। दो संगठन कभी भी क्लस्टर, नेमस्पेस या कनेक्शन पूल साझा नहीं करते हैं।
  • स्वतंत्र प्रवासन। प्रत्येक प्रोजेक्ट माइग्रेट होता है और अपने आप वापस आ जाता है।
  • सादा निर्यात। pg_dump --schema='project_*' किसी प्रोजेक्ट के डेटा, एक्सटेंशन और नीतियों को डंप कर देता है।
साझा स्कीमा

aura_console स्कीमा साझा किया गया है। इसमें projects तालिका और स्टूडियो सत्र हैं। कोई भी एप्लिकेशन डेटा इसके माध्यम से नहीं जाता है।

कर्ल से Postgres तक#

गेटवे प्रत्येक अनुरोध को रूट करने से पहले उसकी जाँच करता है। यह REST क्लाइंट से GET /v1/db/{projectId}/devices का पथ है:

अनुरोध पथtext
1. TLS termination        client → aura-gateway
2. Request ID and tracing request_id and trace_id are attached to the request
3. Rate limit             token bucket, answers 429 when the limit is reached
4. Authentication         JWT decoded and claims checked: sub, project_id, role
5. Circuit breaker        the target service is HEALTHY, so the request goes through
6. Execution              search_path set to the project's schemas, then the query runs under RLS

प्रत्येक चरण tracing के साथ संरचित लॉग लिखता है, जो request_id से सहसंबद्ध होता है।

स्केलिंग#

सेवाएँ राज्यविहीन हैं. क्षमता जोड़ने के लिए, बाइनरी की एक और प्रतिकृति प्रारंभ करें और इसे NATS से कनेक्ट करें। यह क्लस्टर से जुड़ता है और तैयार होने पर अनुरोधों को पूरा करता है। यहां कोई नेता चुनाव नहीं है और कोई वितरित समन्वय नहीं है.

आगे जाने के लिए#