DevCollective.io

devcollective.io

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

1. تثبيت Docker

ستحتاج إلى تثبيت Docker لتمكين Postgres. مستخدمو Windows ، يرجى التأكد من تثبيت امتدادات WSL2 لأنها مطلوبة ل postgres للعمل بشكل صحيح.

2. تثبيت الغزل

لمجموعة متنوعة من الأسباب ، يعتمد هذا المشروع على الغزل. يمكنك تثبيته باستخدام:

npm install -g yarn

3. تثبيت الغزل

سيؤدي هذا إلى تثبيت تبعياتك.

yarn

4. ابدأ قاعدة البيانات الخاصة بك

yarn dbup

هذه الخطوة تنشئ 2 قواعد بيانات postgres في Docker. واحد على المنفذ 10800 هو التطوير ، في حين أن واحد في المنفذ 10801 مخصص لاختبارات الوحدة.

مستخدمي Windows:

إذا رأيت هذا الخطأ:

 The command 'docker-compose' could not be found in this WSL 2 distro.

ثم تأكد من فحص سطح المكتب Docker الخاص بك ضمن الإعدادات/العام الذي يتم فيه فحص "استخدام المحرك المستند إلى WSL 2".

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

لدينا أمر مقصور ، yarn pristine ، يعيد خلق قاعدة البيانات وإعادة تكييفها. يمكنك استخدام هذا الأمر في أي وقت لمسح قاعدة البيانات الخاصة بك وإعادة ضبطه.

yarn pristine

قم بتشغيل البكر في كل مرة يتغير فيها DB.

يجب تشغيل البكر بعد كل تغيير ديسيبل من أجل تحديث قاعدة البيانات الخاصة بك مع أحدث الترحيل.

يمكن استخدام البكر لإعادة تعيين قاعدة البيانات الخاصة بك

يمكن تشغيل البكر في أي وقت لإعادة تعيين قاعدة البيانات الخاصة بك إلى حالة نظيفة. هذا يمكن أن يأتي في متناول يدي في العديد من المواقف.

إذا واجهت مشاكل لا يحلها البكر

إذا واجهت مشاكل أعمق ، فقد ترغب في تدمير مثيلات Postgres الخاصة بك والبدء من الخدش المطلق. هناك أمر يدمر جميع صور Docker والحاويات والأحجام التي لا تعمل حاليًا. أولاً ، سترغب في إيقاف جميع عمليات Docker المتعلقة بهذا المشروع ، ثم تشغيل docker system prune -a . ملاحظة: هذا أمر خطير يدمر كل شيء لا يعمل حاليًا في Docker ، بما في ذلك أي مشاريع غير DC.IO.

6. إعلان رقم المنفذ المخصص لبدء التطبيق

** إنشاء هذا الملف اختياري. إذا لم تنشئ هذا الملف في بيئة DEV ، فسيتم استخدام القيم الافتراضية من ملف Dev.Env الموجود في مجلد Dev.

قم أولاً بإنشاء ملف dev-override.env في مجلد Dev الموجود في دليل الجذر. ثم انسخ ولصق الحقول التالية في ملفك.

 PORT= *

بدلاً من * يمكنك إعلان رقم المنفذ الخاص بك المتوفر في جهازك.

7. ابدأ الخادم الخاص بك

أخيرًا ، يمكنك تشغيل Command yarn dev (Windows: yarn dev:win ) لبدء الخادم. هذا سوف يخدم كل من الواجهة الأمامية والخلفية على الميناء 3000.

8. اختياري: إعداد امتدادات VSCode

تم ملء قائمة تصحيح الأخطاء على VSCode ، والتي تعتمد على Launch.json ، بخيارات تشغيل. يقوم المرء بتشغيل الخادم ، بينما يقوم الآخر بتشغيل اختبارات الوحدة. يتم تمكين كلاهما بنقاط التوقف ، ويمكن أن يكون طريقة رائعة لك أيضًا تصحيح الرمز الخاص بك عند الضرورة.

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

يتيح تثبيت VSCode GraphQL تمييز بناء جملة GraphQL. الموصى بها للعمل GQL.

مستندات مفيدة

كيف تصنع طلب السحب الأول - شكرًا لك ، Julio Alcantara! كيفية إنشاء كيانات جديدة كيفية مزامنة ريبو مع رمز محدث

تكوين الإنتاج

إذا تم نشرها على الإنتاج ، فمن أولاً وضع ملفات التكوين الخاصة بك في /etc/mintbean-v4/config/* . ثم تشغيل yarn start .