تخطَّ إلى المحتوى

أجهزة التطوير

بيئات تطوير معزولة للبناء والاختبار. بيئات Linux كاملة مدعومة بـ Proyecta Cloud.

يُنشئ Proyecta جهاز تطوير مخصصًا (runtime) لكل مشروع. وهو عبارة عن حاوية معزولة تتضمن بيئة Linux كاملة يعمل فيها تطبيقك أثناء التطوير.

كيف تعمل أجهزة التطوير؟

Section titled “كيف تعمل أجهزة التطوير؟”

عند فتح مشروع، يقوم Proyecta بما يلي:

  1. إنشاء حاوية معزولة (pod) في السحابة
  2. استنساخ الكود من GitHub
  3. تثبيت التبعيات وإعداد البيئة
  4. تشغيل development server الخاص بتطبيقك
  5. عرض معاينة مباشرة في Builder

يمكنك متابعة تقدم عملية الإنشاء في Runtime Status Bar أسفل شريط الأدوات.

يعرض شريط الحالة هذه الخطوات أثناء بدء التشغيل:

الخطوةالوصف
Creating podتشغيل الحاوية المعزولة
Health checkالتحقق من أن الحاوية تعمل
Git initاستنساخ المستودع
Environment setupتثبيت التبعيات (npm وpip وغيرها)
Starting servicesتشغيل التطبيق والبنية التحتية
Readyجهاز التطوير جاهز ويعمل بالكامل

جهاز التطوير لديّ يواجه مشكلة. كيف أصلحها؟

Section titled “جهاز التطوير لديّ يواجه مشكلة. كيف أصلحها؟”

إذا كانت المعاينة لا تُحمَّل أو بدا الجهاز متوقفًا:

  1. تحقق من Runtime Status Bar لمعرفة رسائل الخطأ
  2. جرّب استخدام Terminal لفحص السجلات
  3. إذا لم يجدِ ذلك نفعًا، اطلب من الذكاء الاصطناعي مساعدتك في تشخيص المشكلة

يمكن أن يتضمن جهاز التطوير حاويات مساعدة لقواعد البيانات والخدمات:

  • PostgreSQL — قاعدة بيانات علائقية (المنفذ 5432)
  • PostGIS — PostgreSQL مع امتدادات الجغرافيا المكانية (المنفذ 5432)
  • Redis — ذاكرة تخزين مؤقت في الذاكرة (المنفذ 6379)
  • MongoDB — قاعدة بيانات مستندية (المنفذ 27017)
  • MySQL — قاعدة بيانات علائقية (المنفذ 3306)
  • MailHog — خادم اختبار البريد الإلكتروني مع واجهة ويب (منفذ SMTP هو 1025، ومنفذ الواجهة هو 8025)

يمكنك عرض الخدمات الجارية وحالتها في لوحة Services.

تمر أجهزة التطوير بهذه الحالات خلال دورة حياتها:

الحالةالوصف
Pendingفي انتظار الإنشاء
Initializingجارٍ إعداد البيئة
Runningنشط ويعمل بصحة جيدة
Suspendedموقوف مؤقتًا لتوفير الموارد (يستأنف بسرعة)
Archivedمخزَّن في التخزين البارد (يستغرق استعادته وقتًا أطول)
Restoringجارٍ استعادته من التخزين المؤرشف
Failedفشل الإنشاء أو التشغيل — يمكن إعادة إنشاء الجهاز
Terminatedمتوقف نهائيًا

تُوقَف الأجهزة تلقائيًا بعد 60 دقيقة من عدم النشاط، وتُؤرشف بعد 24 ساعة من التوقف.

إذا توقف جهاز التطوير، ماذا يحدث لتطبيقي المنشور؟

يعمل backend تطبيقك (دوال Convex serverless وقاعدة البيانات) على البنية التحتية السحابية الخاصة بـ Convex ويظل متاحًا بصرف النظر عن حالة جهاز التطوير. غير أن ملفات frontend الخاصة بتطبيقك تُقدَّم من جهاز التطوير — فإذا كان موقوفًا أو مؤرشفًا، سيرى الزوار خطأ 503 حتى يستأنف الجهاز عمله. ضع ذلك في الاعتبار للتطبيقات التي تريد إبقاءها متاحة للعموم؛ إذ يُعيد استئناف الجهاز الموقع إلى العمل.

هل يمكنني الحصول على جهاز تطوير أسرع؟

تعمل جميع أجهزة التطوير حاليًا بنفس تخصيص الموارد. إذا كنت بحاجة إلى طاقة أكبر لمشروع ضخم، تواصل مع الدعم.

هل يمكنني الوصول إلى جهاز التطوير مباشرةً؟

نعم. استخدم Terminal المدمج للوصول الكامل إلى shell بيئة التطوير الخاصة بك.