هالة CLI - مرجع كامل
يسمح لك Aura ثنائي الرسمي بالتحكم في منصة Aurabase بالكامل: التطوير المحلي، وKubernetes، وعمليات ترحيل SQL، والوظائف المخزنة، وEdge Functions WASM، وRLS، والتخزين والمصادقة.
ثنائي مستقل، متاح في كل مكان#
سطر الأوامر هو ثنائي مستقل Rust. تم تثبيته اليوم بواسطة NPM على macOS Apple Silicon، وعن طريق التجميع من المصادر في كل مكان آخر. لم يتم إصدار الحزم الثنائية المترجمة مسبقًا لأنظمة التشغيل Linux وmacOS Intel وWindows بعد: فشل npm install -g @aurabase/cli هناك، وهذا ليس خطأ من جانبك.
# 1. NPM – macOS Apple Silicon فقط اعتبارًا من اليوم
npm install -g @aurabase/cli
aura --help
# 2. من المصدر – جميع المنصات (Rust 1.7x+)
git clone https://github.com/Aurabase-cloud/Aurabase.git
cargo install --path Aurabase/aura-cli
# قم بتثبيت الملف الثنائي `aurabase` في ~/.cargo/bin
aurabase --help
مصادقة CLI#
يمكنك تسجيل الدخول باستخدام حساب وحدة التحكم الخاصة بك أو باستخدام رمز وصول شخصي لخطوط أنابيب CI/CD الخاصة بك:
# تسجيل الدخول التفاعلي (يفتح المتصفح)
aura login
# اتصال غير تفاعلي (البريد الإلكتروني / كلمة المرور)
aura login --email dev@example.com --password "secret"
# الاتصال عبر رمز الوصول الشخصي (مثالي لـ GitHub Actions / GitLab CI)
aura login --token aura_pat_9a8b7c6d5e4f...
# التحقق من الحساب والمشروع النشط
aura whoami
مرجع شامل لكل وحدة#
ابحث عن جميع الأوامر والأوامر الفرعية التي يدعمها الملف الثنائي aura:
إعداد المشروع وإدارته
التهيئة والاتصال وتشخيص المشروع
aura init— تهيئة مشروع Aurabase جديد (البنية، التكوين، عامل الإرساء)aura login [--email <email>] [--password <pass>] [--token <pat>]— قم بتسجيل الدخول إلى حساب وحدة التحكم أو باستخدام رمز الوصول الشخصيaura register [--email <email>] [--password <pass>]— إنشاء حساب مطور جديد لوحدة التحكم Aurabaseaura logout— قطع الاتصال بالجلسة المحلية النشطةaura whoami— يعرض المستخدم الذي قام بتسجيل الدخول، ومؤسسته، والمشروع النشطaura link --project-id <uuid>— يربط الدليل الحالي بمشروع سحابي موجودaura status— يعرض حالة المشروع والاتصال وحالة الخدمةaura doctor— تشخيص البيئة المحلية (Docker، المنافذ، أدوات النظام)
التنمية المحلية
إدارة المكدس المحلي (Kubernetes / k3d) والسجلات
aura start- يبدأ جميع الخدمات الصغيرة المحلية Aurabase على k3daura stop— إيقاف خدمات مجموعة k3d والخدمات المحليةaura restart— إعادة تشغيل الخدمات المحليةaura dev— وضع التطوير المستمر: يراقب عمليات الترحيل ويتزامن مع الأنواعaura studio— يفتح واجهة الاستوديو المحلية في متصفحك (المضيف المحلي: 3000)aura logs [-s <service>] [--since 1h] [--tail 100]— يعرض السجلات الموحدة أو المفلترة حسب الخدمة (aura-auth، aura-db، gate...)aura connect— يفتح محطة psql تفاعلية على نقطة النهاية المباشرة للمشروع PostgreSQL (يطلب psql كلمة المرور الصادرة عنaura db connection --new-password)
المنظمات والمشاريع السحابية
إدارة المستأجرين المتعددين للمنظمات والمشاريع
aura orgs list [--json]— يسرد المنظمات التي أنت عضو فيهاaura orgs create --name <name> --slug <slug>— إنشاء مؤسسة سحابية جديدةaura orgs use <slug>— يضبط التنظيم الافتراضي للأوامرaura projects list [--org <slug>] [--json]— يسرد مشاريع المؤسسةaura projects create <name> [--engine postgres|mongodb] [--org <slug>]— توفير مشروع جديدaura projects delete <id>— حذف المشروع وبياناته نهائيًاaura projects api-keys [--project-id <id>]— يعرض مفاتيح واجهة برمجة التطبيقات (API) الخاصة بالمشروع (مجهول، Service_role)aura projects rename <id> <name>— إعادة تسمية مشروع موجودaura projects retry <id>— إعادة تشغيل توفير المشروع فيerrorوطباعة عنوان URL الخاص به والمفاتيح بمجرد أن يصبح جاهزًاaura projects graphql-enable <id> [--wait]— تمكين ملحق GraphQL (pg_graphql) في المشروعaura projects graphql-config <id> [--introspection on|off] [--max-rows N] [--inflect-names on|off] [--wait]— يعرض أو يغير إعدادات pg_graphql (بدون علامة، تتم طباعة الإعدادات سارية المفعول)
فروع قاعدة البيانات (فرع الهالة)
الفرع هو مشروع جديد مستنسخ من مشروع PostgreSQL، مع عنوان URL الخاص به والمفاتيح الخاصة به، ويتم حذفه عند انتهاء TTL الخاص به. راجع فروع قاعدة البيانات فروع قاعدة البيانات لمعرفة الحدود وما يتم استنساخه.
aura branch create <name> [--from <project id|slug|name>] [--org <slug>] [--ttl 72h|3d|2w] [--no-data] [--no-wait] [--json] [--timeout <s>]— ينشئ فرعًا للمشروع المرتبط (أو--from)، وينتظر حتى يصبح جاهزًا، ثم يطبع عنوان URL الخاص به ومفاتيح API الخاصة به مرة واحدة.--ttlينتقل من ساعة واحدة إلى 30 يومًا (الافتراضي 72 ساعة).--no-dataينسخ المخطط فقطaura branch list [--from <project>] [--all] [--json]— يسرد فروع المشروع أو المؤسسة بأكملها باستخدام--all؛ تبقى الفروع الفاشلة مدرجة لمدة 24 ساعة مع ذكر السببaura branch delete <name> [--from <project>] [--force]— حذف الفرع وقاعدة البيانات الخاصة به
قاعدة البيانات والترحيلات (aura db)
إدارة المخطط والمزامنة والدفع/السحب واستعلامات SQL
aura db push— يتم تطبيق عمليات ترحيل SQL المحلية المعلقة (+ المزامنة السحابية إذا كانت مرتبطة)aura db pull— استرداد المخطط البعيد وتحديث المخطط المحليaura db diff [--name <name>]— يقارن المخطط البعيد بالمخطط المحلي وينشئ ترحيل SQLaura db status [--json]— يعرض الحالة التفصيلية لعمليات الترحيل المطبقة والمعلقةaura db watch— مراقبة تغييرات المخطط ومزامنته مباشرةaura db reset [--force]— تطهير قاعدة البيانات المحلية وإعادة إنشائها من البداية (يطلب التأكيد؛--forceللنصوص البرمجية)aura db seed— تشغيل البرنامج النصي Seed.sql لتحميل بيانات الاختبارaura db generate [--lang ts|rust]— إنشاء تعريفات لنوع قاعدة البيانات TypeScript (افتراضي) أو Rustaura db extensions list [--json]/aura db extensions enable <name>— يسرد الامتدادات المثبتة، أو يقوم بتمكين الامتداد المسموح بهaura db inspect <indexes|tables|locks> [--json]— استخدام الفهرس (تم وضع علامة على الفهرس غير المستخدم)، وأحجام الجدول والصفوف الميتة، وحظر الأقفالaura db slow-queries [--limit <n>] [--json]— يسرد أبطأ استعلامات SQL عبرpg_stat_statementsaura db stats [--json]— يعرض إحصائيات الاتصال واستخدام قرص قاعدة البياناتaura db connection [--new-password] [--yes] [--json]- الوصول المباشر PostgreSQL (psql، Prisma، Drizzle،pg_dump): المضيف والمنفذ وقاعدة البيانات والدور؛ باستخدام--new-password، يصدر كلمة مرور (تظهر مرة واحدة، ولا يتم تخزينها بشكل واضح أبدًا، ويلغي كلمة المرور السابقة) ويطبع سلسلة الاتصال الكاملةaura db raw "<sql>" [--params <p1> <p2>] [--dry-run] [--read-only] [--json]— تشغيل استعلام SQL مباشر مع خيارات المحاكاة والقراءة فقطaura db migration new <name>— إنشاء ملف ترحيل SQL جديد ذو طابع زمنيaura db migration list [--json]— يسرد جميع عمليات ترحيل المشروع وحالتهاaura db migration down [n]— إلغاء آخر عدد من عمليات الترحيل المطبقة (الافتراضي: 1)aura db migration repair <file> [--applied|--reverted]— وضع علامة يدويًا على الترحيل على أنه تم تطبيقه أو إلغاؤه في سجل ترحيل المشروع (قراءة نفس السجلaura db statusوmigration list)
RLS الجداول والسياسات (جدول / سياسة aura db)
الإنشاء التعريفي، RLS، في الوقت الفعلي CDC والأذونات
aura db table list [--json]— يسرد جداول المخطط العامة مع أعمدتها وأنواعهاaura db table create <name> "<cols>"— إنشاء جدول (على سبيل المثال: "title:text,tags:text[],embedding:vector(1536)")aura db table drop <name> [-f]— حذف الجدول وقيودهaura db table rls <name> <on|off>— تمكين أو تعطيل الحماية الأمنية على مستوى الصف على الجدولaura db table realtime <name> <on|off>— تمكين أو تعطيل نشر CDC في الوقت الفعلي على الجدولaura db policy list [--table <name>] [--all] [--json]— يسرد سياسات الأمان RLS المحددة في الجداول (--allيتضمن قواعد التخزين الداخلية)aura db policy add <table> <name> <cmd> [--using-expr <expr>] [--check-expr <expr>]— إنشاء سياسة RLS جديدة (SELECT أو INSERT أو UPDATE أو DELETE أو ALL)aura db policy update <table> <name> [--using-expr <expr>] [--check-expr <expr>]— يعدل استخدام / مع التحقق من تعبيرات القاعدة دون كسرaura db policy delete <table> <name> [-f]— يحذف قاعدة الأمان RLS
Postgres وظائف ومشغلات SQL (وظيفة / مشغل aura db)
إجراءات PL/pgSQL المخزنة ومشغلات الجدول
aura db function list [--json]— يسرد وظائف Postgres في المخطط (الاسم والوسائط والأمان والحقوق)aura db function create <name> [--body <sql>|--body-file <f>] [--returns <t>] [--language plpgsql|sql] [--args <a:t>] [--security invoker|definer] [--grant-execute-to <roles>]— إنشاء وظيفة SQL مخزنة أو استبدالها بتحكم صارم في الوصولaura db function drop <name> [-f]- حذف دالة SQL Postgresaura db trigger list <table> [--json]— يسرد جميع المشغلات في الجدولaura db trigger create <table> <name> --function <fn> [--timing before|after|instead_of] --events insert,update [--for-each row|statement]— يربط دالة التشغيل بأحداث الجدولaura db trigger drop <table> <name> [-f]— حذف مشغل على جدول
النسخ الاحتياطية ومفاتيح API (النسخ الاحتياطي لقاعدة بيانات Aura / مفاتيح API)
لقطات واستعادة وإدارة رموز الوصول
aura db backup list [--json]— يسرد النسخ الاحتياطية اليدوية والآلية لقاعدة البياناتaura db backup create [--label <label>]— إنشاء لقطة فورية لقاعدة البياناتaura db backup restore <id> [--verify-only] [--yes]—--yes(أو--force) يتخطى التأكيد المطلوب في البرامج النصية وCI؛ استعادة قاعدة بيانات من لقطة محددةaura db backup download <id> [-o <path>]— قم بتنزيل نسخة SQL الاحتياطية الكاملةaura db backup delete <id> [-f]— حذف أرشيف النسخة الاحتياطيةaura db backup schedule get [--json]— يراجع جدول النسخ الاحتياطي التلقائي الذي تم تكوينهaura db backup schedule set [--frequency hourly|daily|weekly] [--retention-days <n>] [--enable|--disable]— تكوين تكرار النسخ الاحتياطية ومدة الاحتفاظ بهاaura db apikeys list [--json]— يسرد مفاتيح API النشطة المرتبطة بالمشروعaura db apikeys create <name> [--scope anon|authenticated|service_role]— يُنشئ مفتاح API جديدًا له دور محددaura db apikeys revoke <id> [-f]— يلغي مفتاح API على الفور
المصادقة والمستخدمين (مصادقة الهالة)
إدارة الحسابات والجلسات وسجلات التدقيق وقوالب البريد الإلكتروني
aura auth users list [--json]— يسرد المستخدمين المسجلين في المشروعaura auth users create [--email <email>] [--password <pass>] [--json]— إنشاء مستخدم جديد بكلمة مرور (--jsonيطبع المستخدم الذي تم إنشاؤه باستخدامidللنصوص البرمجية)aura auth users delete <id> [-f]— حذف مستخدم نهائيًاaura auth users ban <id>— حظر المستخدم وإلغاء جلساته النشطةaura auth users unban <id>— قم بإلغاء حظر المستخدمaura auth sessions list [--json]— قائمة جلسات JWT النشطةaura auth audit-log [--limit 50] [--json]— عرض سجلات التدقيق الأمني ومحاولات الاتصالaura auth settings get [--json]— يعرض تكوين المصادقة (OAuth, MFA, المهلات)aura auth settings set KEY=VALUE...— تحديث إعدادات المصادقةaura auth email-templates list [--json]— قائمة قوالب البريد الإلكتروني (التأكيد، إعادة التعيين، الرابط السحري)aura auth email-templates get <type>— يعرض كود مصدر HTML/النص الخاص بالقالبaura auth email-templates reset <type> [-f]— إعادة تعيين القالب إلى القيم الافتراضية
وظائف الحافة WASM والأسرار (وظائف الهالة / الأسرار)
نشر ميزات Edge ومتغيرات البيئة المشفرة
aura functions new <name>— يُنشئ الهيكل العظمي لوظيفة Edge جديدةaura functions deploy <name>— يُترجم إلى WASM الثنائي وينشر الوظيفة على الشبكة العالميةaura functions list [--json]— يسرد الوظائف المحلية والمنتشرة مع حالتهاaura functions logs <name>— يعرض دفق السجل في الوقت الفعلي للوظيفةaura functions serve— يبدأ تشغيل خادم الاختبار المحلي للوظائفaura functions invoke <name> [--data '<json>']— استدعاء واختبار وظيفة منشورة مع حمولةaura functions download <name>— تنزيل الكود المصدري لوظيفة عن بعدaura functions delete <name> [-f]— حذف وظيفة الحافة المنشورةaura secrets list --function <name> [--json]— يسرد المتغيرات السرية التي تم تكوينها لوظيفة ماaura secrets set --function <name> KEY=VALUE...— يحدد الأسرار المشفرة التي يتم إدخالها في الوظيفةaura secrets unset --function <name> KEY...— إزالة سر واحد أو أكثر من الوظيفة
تخزين الكائنات (تخزين الهالة)
إدارة دلو ونقل الملفات
aura storage ls [path]— يسرد المجموعات أو الملفات الموجودة في المجلدaura storage cp <src> <dst>— نقل الملفات (مجموعة ↔ محلية)aura storage rm <path>— حذف ملف مخزن في حاويةaura storage mb <name> [--public]— إنشاء مجموعة جديدة (خاصة بشكل افتراضي، أو عامة)aura storage buckets list [--json]— يسرد كافة مجموعات التخزين في المشروعaura storage buckets create <name> [--public]— إنشاء دلو تخزينaura storage buckets delete <name> [-f]— يحذف دلوًا وينظف كل كائناته
البيئة والمرافق المحلية
متغيرات .env وواجهة TUI والتحديث التلقائي والإكمال التلقائي
aura env list [--json]— يعرض المتغيرات المحددة في ملف .env المحليaura env set KEY=VALUE...— يضبط متغيرًا واحدًا أو أكثر في ملف .env المحليaura env unset KEY...— إزالة المتغيرات من ملف .env المحليaura ui— إطلاق TUI التفاعلي الكامل (واجهة المستخدم الطرفية)aura update— يقوم تلقائيًا بفحص واجهة سطر الأوامر (CLI) وتحديثها إلى أحدث إصدار ثابتaura completions <bash|zsh|fish|powershell|elvish>— يُنشئ نصوصًا للإكمال التلقائي لصدفتك
واجهة تفاعلية في المحطة#
Aurabase يدمج واجهة وضع النص (aura ui) المدعومة من Ratatui. فهو يسمح لك بالتنقل في قواعد البيانات الخاصة بك وتنفيذ SQL وفحص الجداول ومتابعة السجلات دون مغادرة المحطة الطرفية الخاصة بك.
# قم بتشغيل واجهة TUI
aura ui
الخيارات والإعدادات العالمية#
--json— إخراج JSON منظم (مثالي للبرمجة النصية وأتمتة jq وCI/CD)--dry-run— تنفيذ الأمر في معاملة تم التراجع عنها في النهاية للتحقق من صحة القيود دون تغيير البيانات--read-only— تأمين المعاملة للقراءة فقط في محرك Postgres-f, --force— يتجاهل طلبات التأكيد التفاعلية للعمليات التدميرية--project-id <uuid>— يستهدف مشروعًا بعيدًا محددًا، متجاهلاً ملف الارتباط المحلي
قم بتمكين الإكمال التلقائي في الصدفة الخاصة بك لتبويب الأوامر تلقائيًا:aura completions zsh > ~/.zfunc/_aura أو aura completions bash > /etc/bash_completion.d/aura.