वास्तुकला
एक अनुरोध आपके क्लाइंट से Postgres तक कैसे जाता है, कैसे संगठन और परियोजनाएं अलग-थलग होती हैं, और सेवाएं कैसे मापी जाती हैं।
एक बैकएंड, आठ सेवाएँ#
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-functions | Edge Functions | WASM और Deno रनटाइम, क्रॉन, एसिंक्रोनस जॉब कतार, डेड-लेटर कतार |
aura-notifications | सूचनाएं | ट्रांजेक्शनल ईमेल (एसएमटीपी), एसएमएस, मोबाइल पुश, HMAC-हस्ताक्षरित वेबहुक |
aura-ai | एआई गेटवे | एक समापन बिंदु के माध्यम से एलएलएम अनुमान, एम्बेडिंग, आरएजी pgvector के साथ |
संगठन और परियोजना द्वारा अलगाव#
प्रत्येक संगठन को अपना स्वयं का PostgreSQL क्लस्टर मिलता है, जो उसके लिए आरक्षित Kubernetes नेमस्पेस में CloudNativePG (CNPG) के साथ प्रावधानित होता है। दो संगठनों के बीच कोई क्लस्टर, नेमस्पेस या कनेक्शन पूल साझा नहीं किया जाता है। क्लस्टर की क्षमता (vCPU, मेमोरी, प्रतिकृतियां) संगठन की योजना का पालन करती है।
उस क्लस्टर के अंदर, प्रत्येक प्रोजेक्ट को अपना Postgres डेटाबेस मिलता है, जो चार स्कीमा में विभाजित होता है। प्रत्येक प्रोजेक्ट की अपनी कनेक्शन भूमिका होती है, जो केवल अपनी भूमिकाओं का सदस्य होता है। किसी प्रोजेक्ट के स्कीमा पर अधिकार उन भूमिकाओं को दिए जाते हैं, न कि PUBLIC को। गेटवे क्लाइंट के JWT में प्रोजेक्ट से कनेक्शन search_path सेट करता है, और एप्लिकेशन टेबल पंक्ति-स्तरीय सुरक्षा (RLS) द्वारा संरक्षित होते हैं।
एंटरप्राइज़ ऑफर पर, एक प्रोजेक्ट को अपने नामस्थान में एक समर्पित CNPG क्लस्टर भी मिल सकता है। अलगाव तब अनुमतियों के अलावा, समूहों के भौतिक पृथक्करण से आता है।
| योजना | मालिक | सामग्री |
|---|---|---|
project_{uuid} | आप | आपकी एप्लिकेशन तालिकाएँ |
project_{uuid}_auth | aura-auth | users, sessions, oauth_accounts, mfa |
project_{uuid}_storage | aura-storage | buckets, 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 का पथ है:
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 से कनेक्ट करें। यह क्लस्टर से जुड़ता है और तैयार होने पर अनुरोधों को पूरा करता है। यहां कोई नेता चुनाव नहीं है और कोई वितरित समन्वय नहीं है.
आगे जाने के लिए#
- डेटाबेस
Postgres, स्कीमा, माइग्रेशन, RLS, TypeScript प्रकार पीढ़ी
- प्रमाणीकरण
OAuth, MFA, सत्र जीवनचक्र, RBAC
- रियल टाइम
वेबसॉकेट, एसएसई, उपस्थिति, Postgres परिवर्तन
- भंडारण
S3-संगत बकेट, रूपांतरण, हस्ताक्षरित यूआरएल
- Edge Functions
WASM और Deno रनटाइम, क्रॉन, डेड-लेटर कतार
- कन्वेंशनों
स्कीमा, कॉलम और RLS नीतियों का नामकरण