انتقل إلى المحتوى
شعار أوراباسي
aurabase

هالة CLI - مرجع كامل

يسمح لك Aura ثنائي الرسمي بالتحكم في منصة Aurabase بالكامل: التطوير المحلي، وKubernetes، وعمليات ترحيل SQL، والوظائف المخزنة، وEdge Functions WASM، وRLS، والتخزين والمصادقة.

المرجع12 د قراءةالمستوى مرجعتمت المراجعة في 19‏/08‏/2026

تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.

ثنائي مستقل، متاح في كل مكان#

سطر الأوامر هو ثنائي مستقل Rust. تم تثبيته اليوم بواسطة NPM على macOS Apple Silicon، وعن طريق التجميع من المصادر في كل مكان آخر. لم يتم إصدار الحزم الثنائية المترجمة مسبقًا لأنظمة التشغيل Linux وmacOS Intel وWindows بعد: فشل npm install -g @aurabase/cli هناك، وهذا ليس خطأ من جانبك.

terminalbash
# 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 الخاصة بك:

terminalbash
# تسجيل الدخول التفاعلي (يفتح المتصفح)
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>] — إنشاء حساب مطور جديد لوحدة التحكم Aurabase
  • aura logout — قطع الاتصال بالجلسة المحلية النشطة
  • aura whoami — يعرض المستخدم الذي قام بتسجيل الدخول، ومؤسسته، والمشروع النشط
  • aura link --project-id <uuid> — يربط الدليل الحالي بمشروع سحابي موجود
  • aura status — يعرض حالة المشروع والاتصال وحالة الخدمة
  • aura doctor — تشخيص البيئة المحلية (Docker، المنافذ، أدوات النظام)

التنمية المحلية

إدارة المكدس المحلي (Kubernetes / k3d) والسجلات

  • aura start - يبدأ جميع الخدمات الصغيرة المحلية Aurabase على k3d
  • aura 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>] — يقارن المخطط البعيد بالمخطط المحلي وينشئ ترحيل SQL
  • aura db status [--json] — يعرض الحالة التفصيلية لعمليات الترحيل المطبقة والمعلقة
  • aura db watch — مراقبة تغييرات المخطط ومزامنته مباشرة
  • aura db reset [--force] — تطهير قاعدة البيانات المحلية وإعادة إنشائها من البداية (يطلب التأكيد؛ --force للنصوص البرمجية)
  • aura db seed — تشغيل البرنامج النصي Seed.sql لتحميل بيانات الاختبار
  • aura db generate [--lang ts|rust] — إنشاء تعريفات لنوع قاعدة البيانات TypeScript (افتراضي) أو Rust
  • aura 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_statements
  • aura 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 Postgres
  • aura 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 وفحص الجداول ومتابعة السجلات دون مغادرة المحطة الطرفية الخاصة بك.

terminalbash
# قم بتشغيل واجهة 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.

للذهاب أبعد من ذلك#