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

तैनाती

शून्य-डाउनटाइम माइग्रेशन, परमाणु रोलबैक, GitHub क्रियाएँ / GitLab / CLI के माध्यम से CI/CD, और डेटाबेस शाखाएँ: उत्पादन से पहले माइग्रेशन या नीति का परीक्षण करने के लिए एक परियोजना की एक प्रति।

व्याख्या8 मि॰ पढ़ेंस्तर मध्यवर्ती15 अप्रैल 2026 पर संशोधित

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

तीन परिनियोजन सतहें#

एक Aurabase प्रोजेक्ट तैनात करने के लिए तीन सतहों को उजागर करता है: Postgres स्कीमा (संस्करणित SQL माइग्रेशन), एज फ़ंक्शंस (WASM + क्रॉन + जॉब्स), नीतियां और रहस्य (RLS, env vars, OAuth ऐप्स)। प्रत्येक aura CLI के माध्यम से स्वयं को स्वतंत्र रूप से आगे बढ़ाता है।

सीएलआई (aura) एक एकल बाइनरी है, जिसे npm install -g @aurabase/cli के साथ भी इंस्टॉल किया जा सकता है, और ड्राई-रन, पुष्टिकरण संकेतों और अंतर पूर्वावलोकन का समर्थन करता है। Linux/macOS/Windows संगत।

विकास, पूर्वावलोकन, उत्पादन#

डिफ़ॉल्ट रूप से, एक प्रोजेक्ट में दो वातावरण होते हैं: dev (स्थानीय, कुबेरनेट्स) और prod (क्लाउड)। उत्पादन से पहले अपने डेटा की एक प्रति में बदलाव का प्रयास करने के लिए, एक डेटाबेस शाखा बनाएं।

fluxtext
LOCAL DEV
    $ ./start.sh              → full local stack (k3d)
    $ aura dev                → watch mode + types gen

BRANCH (copy of a project, deleted by its TTL)
    $ aura branch create pr-142 --from my-app --ttl 3d
    $ aura db push            → on the branch project, to try the migration
    $ aura branch delete pr-142

PRODUCTION
    merge to main             → CI run: aura db push
                              → aura deploy functions

संस्करणित SQL, परमाणु रोलबैक#

माइग्रेशन aurabase/migrations में रहते हैं। प्रति परिवर्तन एक फ़ाइल, उपसर्ग में टाइमस्टैम्प। सीएलआई लापता माइग्रेशन को लिंक किए गए प्रोजेक्ट पर लागू करता है; परिवर्तन के बाद अपने TypeScript प्रकारों को npx @aurabase/gen के साथ पुन: उत्पन्न करें।

terminalbash
# एक नया माइग्रेशन बनाएं
aura db migration new add_devices_table
# → ऑराबेस/माइग्रेशन/20260415120000_add_devices_table.sql

# देखें कि कौन से माइग्रेशन लागू हैं या लंबित हैं, फिर उन्हें लिंक किए गए प्रोजेक्ट पर लागू करें
aura db status
aura db push

# TypeScript प्रकार पुन: उत्पन्न करें
npx @aurabase/gen --out src/aurabase.types.ts

# लागू माइग्रेशन की सूची बनाएं
aura db migration list
ध्यान

शून्य-डाउनटाइम माइग्रेशन। नियमों का पालन करें: पहले अशक्त कॉलम जोड़ें, बैकफ़िल अलग करें, अंत में शून्य नहीं की बाधा डालें। सीएलआई आपके लिए पश्चगामी संगतता की जांच नहीं करता है: aura db push से पहले विनाशकारी कथनों (drop column, alter column … type) की समीक्षा करें।

डेटाबेस शाखाएँ#

एक शाखा एक नया प्रोजेक्ट है जो मौजूदा PostgreSQL प्रोजेक्ट से क्लोन किया गया है: इसकी स्कीमा, पंक्ति स्तर की सुरक्षा नीतियां, फ़ंक्शन, ट्रिगर, दृश्य और (जब तक आप केवल स्कीमा के लिए नहीं पूछते हैं) इसकी पंक्तियाँ। इसका अपना यूआरएल, एपीआई कुंजी और डेटाबेस है, इसलिए आप स्रोत को छुए बिना माइग्रेशन चला सकते हैं, नीति का परीक्षण कर सकते हैं या पूर्वावलोकन परिनियोजन को इंगित कर सकते हैं। जब उनका रहने का समय समाप्त हो जाता है तो शाखाएँ स्वचालित रूप से हटा दी जाती हैं।

clibash
# लिंक किए गए प्रोजेक्ट (ऑरा लिंक) से, डिफ़ॉल्ट रूप से 72 घंटे
aura branch create feat/new-checkout

# दूसरे प्रोजेक्ट से 7 दिन रखे गए
aura branch create pr-142 --from my-app --ttl 7d

# केवल स्कीमा: कोई पंक्ति कॉपी नहीं की गई है, अनुक्रम फिर से शुरू होते हैं
aura branch create schema-test --no-data

aura branch list                    # लिंक्ड प्रोजेक्ट की शाखाएँ
aura branch list --all              # संगठन की प्रत्येक शाखा
aura branch delete feat/new-checkout

aura branch create शाखा तैयार होने तक प्रतीक्षा करता है, फिर उसके यूआरएल और उसकी एपीआई कुंजियों को प्रिंट करता है, केवल एक बार को aura projects create की तरह दिखाया जाता है (--json उन्हें स्क्रिप्ट के लिए प्रिंट करता है)। तुरंत वापस लौटने के लिए --no-wait का उपयोग करें और उसके बाद aura branch list का उपयोग करें। एक शाखा एक प्रोजेक्ट है: इसमें aura link --project-id <id> के साथ एक फ़ोल्डर लिंक करें और माइग्रेशन का प्रयास करने के लिए वहां aura db push चलाएं।

बिल्कुल, शाखा क्या है?

एक शाखा एक प्रतिलिपि है जो निर्माण के समय बनाई गई है, न कि एक जीवित प्रतिकृति और न ही एक कॉपी-ऑन-राइट क्लोन: स्रोत पर या उसके बाद से कुछ भी वापस प्रवाहित नहीं होता है। प्लेटफ़ॉर्म स्रोत को एक सुसंगत स्नैपशॉट में पढ़ता है और पंक्तियों को शाखा डेटाबेस में कॉपी करता है, इसलिए समय डेटा के समानुपाती होता है। स्थानीय परीक्षण स्टैक पर, 350,000 पंक्तियों की 333 एमबी तालिका 14 सेकंड में क्लोन की गई थी। एक माइग्रेशन जो शाखा पर काम करता है उसे सामान्य aura db push के साथ उत्पादन पर लागू किया जाता है।

सीमाएँ, पूर्णतः#

कौन बना सकता हैPostgreSQL प्रोजेक्ट से developer या अधिक भूमिका वाले सदस्य, जो सक्रिय है और हाइबरनेटेड नहीं है। MongoDB परियोजना को अस्वीकार कर दिया गया है।
एक शाखा की शाखा बनानाअस्वीकृत: अपने मूल प्रोजेक्ट से शाखा बनाएं।
नामअक्षर, अंक, ., _, - और /, अधिकतम 63 अक्षर, जीवित शाखाओं के बीच प्रति प्रोजेक्ट अद्वितीय (केस असंवेदनशील)।
जीने का समयडिफ़ॉल्ट रूप से 72 घंटे, 1 घंटे से 30 दिन तक (--ttl 1h से --ttl 30d)। समय सीमा समाप्त होने के लगभग एक मिनट के भीतर समाप्त शाखा और उसका डेटाबेस स्वचालित रूप से हटा दिया जाता है। आप इसे पहले भी हटा सकते हैं.
योजना सीमाएक शाखा आपकी परियोजना सीमा (max_projects) के विरुद्ध को नहीं मानती; इसकी प्रति संगठन सक्रिय शाखाओं की अपनी सीमा है (max_branches): फ्री पर 1, प्रो पर 10, टीम पर 25। इसके बाद, BRANCH_LIMIT_REACHED के साथ सृजन को अस्वीकार कर दिया जाता है। एक असफल शाखा की गिनती नहीं होती. सीमाएं देखें।
डेटा आकारपंक्तियों को स्ट्रीम किया जाता है, मेमोरी में नहीं रखा जाता है, इसलिए 32 MiB की कोई सीमा नहीं है। क्लोनिंग से इनकार कर दिया जाता है, कुछ सेकंड में, जब टेबल परिनियोजन की सीमा से अधिक हो जाती है (डिफ़ॉल्ट रूप से 2 GiB, BRANCH_CLONE_MAX_BYTES जब आप Aurabase होस्ट करते हैं): संदेश आकार देता है और --no-data का सुझाव देता है। एक क्लोन भी 30 मिनट के बाद बंद हो जाता है।

क्या क्लोन नहीं किया गया है#

  • क्लोन किया गया: टेबल और उनकी पंक्तियाँ, कॉलम प्रकार, डिफ़ॉल्ट, पहचान कॉलम, अनुक्रम और उनके वर्तमान मूल्य, बाधाएं, सूचकांक, पंक्ति स्तर की सुरक्षा (सक्षम, मजबूर, नीतियां), एसक्यूएल फ़ंक्शन और प्रक्रियाएं, ट्रिगर, दृश्य और भौतिक दृश्य, एनम प्रकार, और उन सभी पर विशेषाधिकार।
  • क्लोन नहीं किया गया: प्रमाणीकरण उपयोगकर्ता, सत्र और प्रमाणीकरण सेटिंग्स; भंडारण बाल्टियाँ और वस्तुएँ; एज फ़ंक्शंस, रहस्य, पर्यावरण चर और क्रॉन जॉब्स; रीयलटाइम तालिका सेटिंग्स (उन्हें शाखा पर पुनः सक्षम करें); तालिका और स्तंभ टिप्पणियाँ, जिनमें @graphql निर्देश शामिल हैं; स्तंभ-स्तरीय विशेषाधिकार; pg_graphql सक्रियण (शाखा पर aura projects graphql-enable)। ऑब्जेक्ट का स्वामित्व शाखा की व्यवस्थापक भूमिका के पास होता है।
  • ने अस्वीकार कर दिया (शाखा अधूरी होगी): विभाजित और विरासत में मिली तालिकाएँ, विदेशी तालिकाएँ, डोमेन, समग्र और श्रेणी प्रकार, समग्र कार्य, नियम फिर से लिखना, विदेशी कुंजियाँ जो किसी अन्य स्कीमा की ओर इशारा करती हैं, और प्लेटफ़ॉर्म द्वारा प्रत्येक प्रोजेक्ट में इंस्टॉल किए गए एक्सटेंशन के अलावा अन्य एक्सटेंशन।

स्कीमा से एक शाखा बनाई जाती है क्योंकि इसे कॉपी से ठीक पहले पढ़ा जाता है। शाखा बनाते समय स्रोत (aura db push, DDL) का स्कीमा न बदलें।

जब सृजन विफल हो जाता है#

कुछ भी पीछे नहीं छूटा. प्रतिलिपि शाखा डेटाबेस पर एकल लेनदेन में चलती है; किसी भी विफलता पर इसे वापस लाया जाता है, शाखा प्रोजेक्ट हटा दिया जाता है, और aura branch create कारण प्रिंट करता है (उदाहरण के लिए ऑब्जेक्ट जिसे क्लोन नहीं किया जा सकता है)। विफल शाखा अपने संदेश के साथ aura branch list में 24 घंटे तक दृश्यमान रहती है, और उसका नाम फिर से मुफ़्त है। यदि डेटाबेस सेवा किसी प्रतिलिपि के बीच में पुनरारंभ होती है, तो शाखा को विफल घोषित कर दिया जाता है और 45 मिनट के बाद हटा दिया जाता है।

तीन एकीकरण तैयार#

सीएलआई किसी भी सीआई के साथ काम करता है। यहां तीन सबसे आम व्यंजन हैं।

.github/workflows/deploy.ymlyaml
name: Deploy to Aurabase
on:
  push: { branches: [main] }

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm install -g @aurabase/cli   # या रिलीज़ पेज से बाइनरी डाउनलोड करें
      - run: aura login --token ${{ secrets.AURA_PAT }}   # व्यक्तिगत एक्सेस टोकन aura_pat_*
      - run: aura link ${{ vars.AURA_PROJECT_ID }}
      - run: aura db push
      - run: aura deploy functions

प्रति परिवेश एक प्रोजेक्ट को लिंक करें (एक स्टेजिंग प्रोजेक्ट और एक प्रोडक्शन प्रोजेक्ट) और प्रत्येक के विरुद्ध समान पाइपलाइन चलाएँ। कोई --env ध्वज नहीं है: लक्ष्य वह प्रोजेक्ट है जिससे फ़ोल्डर जुड़ा हुआ है।

परमाणु, डाउन माइग्रेशन के माध्यम से#

प्रत्येक 20260415_xxx.sql माइग्रेशन के आगे एक 20260415_xxx.down.sql फ़ाइल हो सकती है। aura db migration down [n] पिछले n लागू माइग्रेशन के .down.sql को चलाता है, सबसे पहले, और उन्हें इतिहास से हटा देता है; कमांड सर्वर के उत्तर की जाँच करता है और यदि कुछ भी पूर्ववत नहीं किया गया तो विफल हो जाता है। .down.sql के बिना माइग्रेशन को केवल इतिहास से हटा दिया जाता है, और सीएलआई ऐसा कहता है।

rollbackbash
# अंतिम लागू माइग्रेशन को पूर्ववत करें (इसे .down.sql चलाता है)
aura db migration down

# अंतिम तीन को पूर्ववत करें
aura db migration down 3

# स्कीमा को छुए बिना इतिहास को ठीक करें (हाथ से लागू माइग्रेशन, विफल)
aura db migration repair 20260415120000_add_devices_table.sql --applied

# एक असफल माइग्रेशन अपने ही लेन-देन में रद्द कर दिया जाता है: वापस करने के लिए कुछ भी नहीं।
# संपूर्ण डेटाबेस की पॉइंट-इन-टाइम पुनर्प्राप्ति बैकअप के माध्यम से होती है (aura db बैकअप रिस्टोर <id> --हाँ)
ध्यान

पॉइंट-इन-टाइम पुनर्प्राप्ति के पास अभी तक कोई स्वयं-सेवा कमांड नहीं है। पुनर्स्थापना के लिए आप स्वयं ड्राइव करें, aura db backup create / aura db backup restore <id> --yes के स्नैपशॉट का उपयोग करें; पुनर्स्थापना डेटाबेस को अधिलेखित कर देती है, इसलिए पहले एक ताज़ा बैकअप लें।

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