أداة سطر الأوامر

CLI غيمة

أداة سطر الأوامر الرسمية لإدارة تطبيقاتك على منصة غيمة السحابية. نشر التطبيقات، إدارة المشاريع، والتحكم الكامل في بنيتك التحتية من طرفك.

curl -sSl https://cli.ghaymah.systems/install.sh | bash
source ~/.bashrc

تثبيت CLI غيمة

اتبع هذه الخطوات لتثبيت أداة سطر الأوامر على نظامك.

1

تشغيل أمر التثبيت

افتح طرفيتك (Terminal) وقم بتنفيذ الأمر التالي:

$ curl -sSl https://cli.ghaymah.systems/install.sh | bash🔄 Installing Ghaymah CLI...✅ Installation complete! You may need to restart your terminal.
2

التحقق من التثبيت

بعد اكتمال التثبيت، تحقق من أن الأداة تعمل بشكل صحيح:

$ gy --versionCurrent version: 0.0.21Latest version: 0.0.21✅ You are using the latest version!

⚠️ملاحظة لمستخدمي ويندوز

تحتاج إلى تثبيت وتكوين WSL (نظام التشغيل الفرعي لنظام التشغيل Windows) لاستخدام CLI غيمة على نظام Windows.

يمكنك اتباع الدليل الرسمي من Microsoft لتثبيت WSL.

المصادقة

قم بتسجيل الدخول إلى حساب غيمة الخاص بك عبر CLI.

تسجيل الدخول

gy auth login

هذا سيدعوك لإدخال البريد الإلكتروني وكلمة المرور اللذين استخدمتهما عند التسجيل في موقع deploy.ghaymah.systems

مثال:$ gy auth login

حالة المصادقة

gy auth status

يعرض معلومات حول حالة تسجيل الدخول الحالية، بما في ذلك الحساب المستخدم وجلسة العمل.

مثال:$ gy auth statusمسجل الدخول كمحمد (mohamed@example.com)

إدارة المشاريع

قم بإنشاء وإدارة مشاريع غيمة الخاصة بك عبر CLI.

عرض المشاريع

gy resource project get

يعرض قائمة بجميع المشاريع في حسابك مع معرفاتها الفريدة. ستحتاج إلى معرف المشروع (Project ID) لتنفيذ عمليات أخرى.

مثال:[ { "id": "prj_123456789", "name": "موقعي الإلكتروني", "created_at": "2023-06-15T08:30:00Z" }]

إنشاء مشروع جديد

gy resource project create --set .name=my-new-project

ينشئ مشروعًا جديدًا ويعرض معرف المشروع (Project ID) الذي ستحتاجه لاحقًا.

مثال:$ gy resource project create --set .name=mynewprojectتم إنشاء المشروع بنجاح!Project ID: prj_987654321

💡ملاحظة مهمة

احفظ معرف المشروع (Project ID) الذي يعرضه CLI بعد إنشاء المشروع، لأنك ستحتاجه لنشر التطبيقات في هذا المشروع.

نشر التطبيقات

نشر تطبيقاتك على منصة غيمة باستخدام CLI.

1

تهيئة التطبيق

انتقل إلى مجلد المشروع الخاص بك وتأكد من وجود ملف Dockerfile في الجذر. ثم قم بتهيئة التطبيق:

$ gy resource application init --project-id prj_987654321تم إنشاء ملف .ghaymah.json بنجاح

💡ملف التهيئة

يقوم هذا الأمر بإنشاء ملف .ghaymah.json في مجلد مشروعك يحتوي على إعدادات النشر الأساسية مثل منفذ التطبيق وحجم المثيل.

2

تعديل ملف التهيئة

افتح ملف .ghaymah.json وتأكد من أن المنفذ (port) مطابق للمنفذ الذي يعمل عليه تطبيقك محليًا:

مثال لملف .ghaymah.json:{ "id": "58bd02a2-a77a-4816-a6ab-468af19555bc", "name": "yt-transcript-api", "projectId": "79e27780-d883-4149-875a-6a3bdf4cb344", "ports": [ { "expose": true, "number": 5000 } ], "publicAccess": { "enabled": true, "domain": "auto" }, "resourceTier": "t1", "dockerFileName": "Dockerfile"}

⚠️تحذير

تأكد من أن قيمة المنفذ (number) داخل مصفوفة ports في ملف .ghaymah.json مطابقة للمنفذ الذي يعمل عليه تطبيقك محليًا، وإلا لن يعمل التطبيق بعد النشر.

3

نشر التطبيق

قم بتشغيل أمر النشر لبناء صورة Docker ونشر التطبيق على غيمة:

$ gy resource application launchيتم بناء الصورة...يتم نشر التطبيق...تم النشر بنجاح!يمكنك الوصول للتطبيق على: https://myapp-abc123.ghaymah.systems

تتبع حالة النشر

gy resource application logs

يعرض سجلات التطبيق (logs) لمتابعة حالة النشر واستكشاف الأخطاء إن وجدت.

تهيئة التطبيق

خيارات إضافية لتهيئة تطبيقك قبل النشر.

إعداد المتغيرات البيئية

يمكنك إضافة متغيرات بيئية إلى ملف .ghaymah.json كما يلي:

مثال لملف .ghaymah.json مع متغيرات بيئية:{ "projectId": "prj_987654321", "port": 3000, "instanceSize": "small", "env": { "DATABASE_URL": "postgres://user:pass@host:5432/db", "API_KEY": "your-api-key-here" }}

💡أمان المتغيرات البيئية

لا تخزن معلومات حساسة مثل كلمات المرور مباشرة في ملف التهيئة. استخدم بدلاً من ذلك إدارة الأسرار (Secrets Management) في لوحة تحكم غيمة.

إعداد النطاق المخصص

لإضافة نطاق مخصص (Custom Domain) لتطبيقك، أضف إعدادات المجال إلى ملف .ghaymah.json:

مثال لملف .ghaymah.json مع إعدادات المجال:{ "projectId": "prj_987654321", "port": 3000, "domains": ["example.com", "www.example.com"]}

💡ملاحظة

بعد إضافة النطاقات إلى ملف التهيئة، ستحتاج إلى تكوين سجلات DNS للنطاق لتوجيهه إلى غيمة. اتبع التعليمات في لوحة تحكم غيمة بعد النشر.

غيمة

أول مزود سحابي عربي مصمم للمنطقة والعصر

© 2025 غيمة. جميع الحقوق محفوظة.