عندما اقوم بتحميل مشروع من github
mern stack كيف يتم التشغيل ؟
تشغيل مشروع mernstack كيف ؟
أولاً عليك بتهيئة بيئة العمل وذلك من خلال تثبيت Node.js من خلال الموقع الرسمي وتثبيت نسخة LTS:
ولكن أنا أفضل استخدام مدير إصدارات Node وهو NVM من أجل التمكن من تثبيت أكثر من إصدار والتبديل بينهم وأيضًا تجنب بعض المشاكل، والطريقة الأولى هي الأسهل في نظر البعض.
بعد ذلك ستحتاج إلى فتح مجلد المشروع الخاص بالواجهة الأمامية React ثم مجلد المشروع الخاص بالواجهة الخلفية node.js في محرر vscode ثم تثبيت الحزم الموجودة في ملف package.json بتنفيذ الأمر التالي في منفذ الأوامر سواء في vscode أو خارجه ولكن يجب أن يكون المسار هو مسار مجلد المشروع في منفذ الأوامر:
npm i
ولكن في بعض الأحيان قد تواجه مشكلة بسبب تعارض في إصدارات الحزم وحلها من خلال الأمر التالي:
npm i --legacy-peer-deps
وسيتعين عليك تثبيت الحزم في مجلد الخادم ومرة أخرى في مجلد الواجهة الأمامية الخاص بـ React.
بعد ذلك في مجلد الخادم ستحتاج إلى تعديل إعدادات قاعدة البيانات في حال كان المشروع يعتمد على قاعدة بيانات، وذلك بإعداد وتكوين قاعدة البيانات المطلوبة، (مثل اسم المستخدم وكلمة المرور لقاعدة البيانات لديك) وتكوينها وفقًا لمتطلبات المشروع.
ثم تشغيل الخادم عن طريق سكريبت التشغيل وتستطيع رؤيته في ملف package.json وفي العادة يكون باسم start والتشغيل كالتالي:
npm start
ثم تشغيل الواجهة الأمامية من خلال سكريبت التشغيل وعادة ما يكون باسم start أيضًا وتستطيع التأكد من ملف package.json.
ومن المفترض أن تجد خطوات التشغيل مشروحة في المستودع في حال وجود ملف Readme.md.
بإشارتك للمشروع كمشروع MERM يفترض أن يكون هنالك طرفان، طرف الخادم وطرف العميل. وستحتاج لتشغيل كامل التطبيق بصورة صحيحة تهيئة كليهما بصورة صحيحة، وفيما يلي تفاصيل ذلك:
مشروع React أو تطبيق العميل:
نقوم بتثبيت اعتماديات Node بإستعمال الأمر:
npm install
قد يكون اضافة الخيار force-- ضروريا لجبر التثبيت:
npm install --force
الآن ما عليك إلا تشغيل خادم التطوير باستخدام الأمر:
npm run start
مشروع Node أو تطبيق الخادم:
نقوم بتثبيت اعتماديات Node بإستعمال الأمر:
npm install
ونفس الشيء بخصوص الخيار force--
قد يكون هنالك ملف لإعداد متغيرات البيئة من مثل رابط قاعدة البيانات أو ما الى ذلك، ولذلك تأكد من مصادقة Mongodb مع تطبيق الخادم في حال ما كان ذلك.
ابحث عن ملف env. وأضف إليه رابط قاعدة بياناتك على Mongodb:
mongodb://mongodb0.example.com:27017
الآن ما عليك إلا تشغيل أحد الأمرين -عادة-:
npm run start nodemon start
طبعا فإنه من الضروري أيضا ضبط Base URL لتطبيق الخادم في تطبيق العميل في مكان ما، اذ أنه ما يتوصلان به مع بعض.
سيجب بطبيعة الحال تشغيل كلا الأمرين الاخيرين بخصوص كل تطبيق -العميل والخادم- لضمان اشتغال التطبيق بصورة صحيحة.
قد يكون هنالك بعض المشاكل الأخرى، التي ينبغي العمل عليها وتشخيصها بشكل منفصل تماما.
تعليمات مفصلة لتشغيل مشروع mern stack من GitHub:
تنزيل المشروع من GitHub بإما:
- Cloning الرابط الموجود على GitHub باستخدام أمر:
- git clone <repository URL>
- تنزيل ملف .zip المرفق على GitHub.
تثبيت Node.js و MongoDB على جهازك إن لم تكن مثبتة:
- Node.js: تثبيت الإصدار الأحدث من موقعهم الرسمي.
- MongoDB: تثبيت الإصدار الأحدث من موقعهم الرسمي ثم تشغيل قاعدة البيانات بأمر:
- mongod
فتح سطر أوامر داخل مجلد المشروع وتنزيل المكتبات باستخدام أمر:
npm install
تشغيل التطبيق بسطر أوامر آخر باستخدام أمر:
npm start
سيشير ظهور رسالة "Server running on port" إلى أن التطبيق يعمل ويمكن الوصول إليه عبر المنفذ المحدد.
ممكن تفحص الملفات داخل المشروع لفهم كيفية عمله مثل ملفات الـ API والمكونات وقواعد البيانات.
التعليقات