واجهة الأوامر
ثبّت واجهة الأوامر، وسجّل الدخول بمفتاح واجهة برمجة، وأدِر كل شيء من طرفيّتك.
تقود واجهة أوامر غيمة حسابك من الطرفيّة — النشر، وتتبّع السجلات، وإدارة الخدمات وقواعد البيانات والتخزين. تُصادِق بمفتاح واجهة برمجة الحساب.
التثبيت وتسجيل الدخول#
npm install -g @gheima/cli
gheima loginأنشئ مفتاح واجهة برمجة في Settings → API keys، ثم الصقه عند الطلب (يبدأ بـ gh_). يُخزَّن المفتاح لكل ملف تعريف في ~/.config/gheima/config.json (بوضع 600). يمكنك أيضًا تخطّي تسجيل الدخول بضبط متغيّر البيئة GHEIMA_API_KEY.
تُحلّ المصادقة بهذا الترتيب: خيار --key، ثم GHEIMA_API_KEY، ثم ملف التعريف المخزّن. استخدم --profile <name> للاحتفاظ بمفاتيح منفصلة (مثلًا العمل والشخصي)؛ ويحذف gheima logout واحدًا.
الخيارات العامة#
- -k, --key <key>
- مفتاح واجهة البرمجة لهذا الاستدعاء (يتجاوز متغيّر البيئة وملف التعريف).
- -u, --url <url>
- رابط الأساس لواجهة البرمجة (افتراضيًا https://gheima.ma).
- -p, --profile <name>
- أي ملف تعريف مخزّن يُستخدم.
- --json
- طباعة JSON قابل للمعالجة بدل جدول.
- -v, --version
- طباعة إصدار واجهة الأوامر.
أوامر الحساب#
- gheima login
- المصادقة بمفتاح واجهة برمجة وتخزينه في ملف تعريف.
- gheima logout
- حذف ملف تعريف مخزّن.
- gheima whoami
- عرض حساب المفتاح النشط (الاسم، slug، الخطة، النوع).
- gheima status
- عرض الحساب والخطة وعدد الموارد.
- gheima open [resource]
- فتح لوحة التحكّم (أو مسار) في المتصفّح.
- gheima completion [shell]
- طباعة سكربت إكمال لـ bash أو zsh أو fish.
أوامر الخدمة#
الأوامر التي تأخذ <service> تقبل معرّفه أو اسمه أو slug. تطلب الأوامر التدميرية تأكيدًا ما لم تمرّر -y / --yes.
- gheima services
- سرد الخدمات (اسم بديل لـ services list؛ وأيضًا service، svc).
- gheima services get <id>
- عرض خدمة بالتفصيل.
- gheima services create --name <name> [--project <id>] [--type WEB|WORKER|STATIC] [--repo <url>]
- أنشئ خدمة (النوع الافتراضي WEB؛ احذف --project لتركها غير مجمّعة).
- gheima services delete <id> [-y]
- حذف خدمة.
- gheima deploy [service]
- إطلاق نشر؛ يطلب الخدمة إن حُذفت.
- gheima logs <service> [-f] [-b] [-s <text>]
- عرض السجلات أو تتبّعها. -f تتبّع، -b سجلات البناء، -s تصفية.
- gheima env pull <service>
- سرد مفاتيح المتغيّرات بقيم مقنّعة.
- gheima env set <service> KEY=value
- ضبط متغيّر بيئة.
- gheima env rm <service> <key> [-y]
- حذف متغيّر بيئة.
- gheima domains <service>
- سرد النطاقات المخصّصة لخدمة.
أوامر الموارد#
- gheima db
- سرد قواعد البيانات (اسم بديل databases).
- gheima storage buckets
- سرد حاويات تخزين الكائنات.
- gheima storage ls <bucket> [prefix]
- سرد كائنات حاوية.
- gheima storage cp <file> <bucket> [key]
- رفع ملف محلي عبر رابط موقّع مسبقًا.
- gheima storage get <bucket> <key> [dest]
- تنزيل كائن.
- gheima storage rm <bucket> <key> [-y]
- حذف كائن.
- gheima cron
- سرد مهام كرون.
- gheima webhooks
- سرد الويب هوكس.
gheima services create --name web --type WEB --repo https://github.com/me/app
gheima deploy web
gheima logs web -f -s error
gheima env set web NODE_ENV=production
gheima storage cp ./photo.png my-bucket images/photo.png
gheima services --json | jq '.[].url'✦ كل ما في لوحة التحكّم على بُعد أمر واحد — برمِج النشر والسجلات وإدارة الموارد من الصدفة.