تشغيل بيئة التطوير

إذا كنت تريد المساهمة في Climweb، فأنت بحاجة إلى إعداد بيئة التطوير على جهاز الكمبيوتر المحلي الخاص بك. أفضل طريقة للقيام بذلك هي عبر Docker compose بحيث يمكنك بدء التطبيق بأقل قدر من المتاعب.

ملاحظة

لنشر الإنتاج، يرجى زيارة https://github.com/wmo-raf/climweb-docker

استنساخ المستودع

الخطوة الأولى هي استنساخ مستودع Climweb من GitHub. يمكنك القيام بذلك عن طريق تشغيل الأمر التالي في جهازك الطرفي:

$ git clone https://github.com/wmo-raf/climweb.git
$ cd climweb

قم بإنشاء ملف ".env".

بعد ذلك، تحتاج إلى إنشاء ملف بيئة يحتوي على التكوين الضروري لبيئة التطوير. يمكنك القيام بذلك عن طريق نسخ ملف بيئة التطوير النموذجي الموجود في المستودع:

$ cp .env.dev.sample .env

قم بتحديث الملف .env بالتكوين المطلوب. راجع قسم متغيرات البيئة كمرجع حول متغيرات البيئة المتوفرة وأوصافها.

بداية سريعة

إذا كنت على دراية بـ git وDocker Compose، فقم بتشغيل هذه الأوامر لتشغيل بيئة تطوير Climweb محليًا، وإلا فيرجى البدء من قسم متطلبات التثبيت أدناه.

$ git clone https://github.com/wmo-raf/climweb.git

# Our supplied ./dev.sh script wraps Docker Compose setting the correct env vars for

# you to get hot code reloading working well.

$ ./dev.sh

# Run ./dev.sh help for further details.

$ ./dev.sh help

متطلبات التثبيت

إذا لم تكن قد قمت بالفعل بتثبيت docker وDocker Compose على جهاز الكمبيوتر الخاص بك، فيمكنك القيام بذلك عن طريق اتباع الإرشادات الموجودة على https://docs.docker.com/desktop وhttps://docs.docker.com/compose/install

ملاحظة

يعد إصدار Docker 19.03 هو الحد الأدنى المطلوب لإنشاء Climweb. ومع ذلك، يُنصح بشدة بتثبيت أحدث إصدار متاح من Docker. يرجى التحقق من تحديث عامل الإرساء الخاص بك عن طريق تشغيل "docker -v".

ستحتاج أيضًا إلى تثبيت git، ويمكنك القيام بذلك باتباع الإرشادات الموجودة على https://www.linode.com/docs/development/version-control/how-to-install-git-on-linux-mac-and-windows.

بمجرد الانتهاء من تثبيت جميع البرامج المطلوبة، من المفترض أن تكون قادرًا على تشغيل الأوامر التالية في جهازك الطرفي.

$ docker -v
Docker version 28.1.1, build 4eba377
$ docker compose version
Docker Compose version v2.35.1-desktop.1
$ git --version
git version 2.37.1

إذا أعادت جميع الأوامر شيئًا مشابهًا كما هو موضح في المثال، فأنت جاهز للمتابعة!

بدء بيئة التطوير

أولاً، تحتاج إلى استنساخ المستودع. قم بتنفيذ الأوامر التالية لاستنساخ الفرع الرئيسي. إذا لم تكن على دراية بـ git clone، فسيؤدي ذلك إلى تنزيل نسخة من كود Climweb على جهاز الكمبيوتر الخاص بك.

$ git clone https://github.com/wmo-raf/climweb.git
Cloning into 'climweb'...
...
$ cd climweb

الآن بعد أن حصلنا على نسختنا من الريبو وقمنا بتغيير الدلائل إلى climweb الذي تم إنشاؤه حديثًا، يمكننا إظهار الحاويات.

إذا كنت لا تريد استخدام البرنامج النصي dev.sh المتوفر، فيمكنك تشغيل الأمر التالي لبدء بيئة التطوير:

$ docker compose -f docker-compose.yml -f docker-compose.dev.yml up

ملاحظة

لاحظ أنه يتم استخدام الملف "docker-compose.dev.yml" لتجاوز الملف الافتراضي "docker-compose.yml" بإعدادات خاصة بالتطوير.

الوصول إلى تطبيق الويب

بمجرد إعداد الحاويات وتشغيلها، يمكنك الوصول إلى تطبيق Climweb في متصفح الويب الخاص بك على http://localhost:8000. يمكن تغيير المنفذ في الملف .env إذا لزم الأمر عن طريق تعديل المتغير CLIMWEB_DEV_PORT.

إنشاء مستخدم متميز

لإنشاء مستخدم متميز لتطبيق Climweb، يمكنك تشغيل الأمر التالي في نافذة طرفية منفصلة:

$ docker compose -f docker-compose.yml -f docker-compose.dev.yml exec climweb climweb createsuperuser

حافظ على تشغيل الحاوية

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