انتقل إلى المحتوى

تهيئة wis2box

نتائج التعلم

بنهاية هذه الجلسة العملية، ستكون قادرًا على:

  • تشغيل سكربت wis2box-create-config.py لإنشاء التهيئة الأولية
  • بدء تشغيل wis2box والتحقق من حالة مكوناته
  • عرض محتويات wis2box-api
  • الوصول إلى wis2box-webapp
  • الاتصال بـ wis2box-broker المحلي باستخدام MQTT Explorer

Note

تعتمد المواد التدريبية الحالية على الإصدار 1.2.0 من wis2box.

راجع accessing-your-student-vm للحصول على تعليمات حول كيفية تنزيل وتثبيت حزمة برامج wis2box إذا كنت تقوم بإجراء هذا التدريب خارج جلسة تدريب محلية.

التحضير

قم بتسجيل الدخول إلى الجهاز الافتراضي المخصص لك باستخدام اسم المستخدم وكلمة المرور الخاصة بك، وتأكد من أنك في دليل wis2box:

cd ~/wis2box

إنشاء التهيئة الأولية

تتطلب التهيئة الأولية لـ wis2box ما يلي:

  • ملف بيئة wis2box.env يحتوي على معلمات التهيئة
  • دليل على الجهاز المضيف لمشاركته بين الجهاز المضيف وحاويات wis2box، يتم تعريفه بواسطة متغير البيئة WIS2BOX_HOST_DATADIR

يمكن استخدام سكربت wis2box-create-config.py لإنشاء التهيئة الأولية لـ wis2box.

سيطلب منك مجموعة من الأسئلة للمساعدة في إعداد التهيئة.

ستتمكن من مراجعة وتحديث ملفات التهيئة بعد انتهاء السكربت.

قم بتشغيل السكربت كما يلي:

python3 wis2box-create-config.py

دليل wis2box-host-data

سيطلب منك السكربت إدخال الدليل الذي سيتم استخدامه لمتغير البيئة WIS2BOX_HOST_DATADIR.

يرجى ملاحظة أنه يجب عليك تحديد المسار الكامل لهذا الدليل.

على سبيل المثال، إذا كان اسم المستخدم الخاص بك هو username، فإن المسار الكامل للدليل هو /home/username/wis2box-data:

username@student-vm-username:~/wis2box$ python3 wis2box-create-config.py
Please enter the directory to be used for WIS2BOX_HOST_DATADIR:
/home/username/wis2box-data
The directory to be used for WIS2BOX_HOST_DATADIR will be set to:
    /home/username/wis2box-data
Is this correct? (y/n/exit)
y
The directory /home/username/wis2box-data has been created.

عنوان URL الخاص بـ wis2box

بعد ذلك، سيُطلب منك إدخال عنوان URL الخاص بـ wis2box. هذا هو العنوان الذي سيتم استخدامه للوصول إلى تطبيق الويب، API، وواجهة المستخدم الخاصة بـ wis2box.

يرجى استخدام http://<your-hostname-or-ip> كعنوان URL.

Please enter the URL of the wis2box:
 For local testing the URL is http://localhost
 To enable remote access, the URL should point to the public IP address or domain name of the server hosting the wis2box.
http://username.training.wis2dev.io
The URL of the wis2box will be set to:
  http://username.training.wis2dev.io
Is this correct? (y/n/exit)

كلمات المرور لـ WEBAPP، STORAGE و BROKER

يمكنك استخدام خيار إنشاء كلمات مرور عشوائية عند المطالبة بـ WIS2BOX_WEBAPP_PASSWORD، WIS2BOX_STORAGE_PASSWORD، و WIS2BOX_BROKER_PASSWORD أو تحديد كلمات المرور الخاصة بك.

لا تقلق بشأن تذكر هذه الكلمات، حيث سيتم تخزينها في ملف wis2box.env في دليل wis2box الخاص بك.

مراجعة ملف wis2box.env

بمجرد اكتمال السكربت، تحقق من محتويات ملف wis2box.env في الدليل الحالي:

cat ~/wis2box/wis2box.env

أو تحقق من محتويات الملف عبر WinSCP.

Question

ما هي قيمة WISBOX_BASEMAP_URL في ملف wis2box.env؟

اضغط للكشف عن الإجابة

القيمة الافتراضية لـ WIS2BOX_BASEMAP_URL هي https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png.

يشير هذا العنوان إلى خادم OpenStreetMap للبلاط. إذا كنت ترغب في استخدام مزود خرائط مختلف، يمكنك تغيير هذا العنوان للإشارة إلى خادم بلاط مختلف.

Question

ما هي قيمة متغير البيئة WIS2BOX_STORAGE_DATA_RETENTION_DAYS في ملف wis2box.env؟

اضغط للكشف عن الإجابة

القيمة الافتراضية لـ WIS2BOX_STORAGE_DATA_RETENTION_DAYS هي 30 يومًا. يمكنك تغيير هذه القيمة إلى عدد مختلف من الأيام إذا أردت.

يقوم حاوية wis2box-management بتشغيل مهمة مجدولة يوميًا لإزالة البيانات الأقدم من عدد الأيام المحدد بواسطة WIS2BOX_STORAGE_DATA_RETENTION_DAYS من حاوية wis2box-public والواجهة الخلفية لـ API:

0 0 * * * su wis2box -c "wis2box data clean --days=$WIS2BOX_STORAGE_DATA_RETENTION_DAYS"

Note

يحتوي ملف wis2box.env على متغيرات البيئة التي تحدد تهيئة wis2box الخاص بك. لمزيد من المعلومات، راجع wis2box-documentation.

لا تقم بتحرير ملف wis2box.env إلا إذا كنت متأكدًا من التغييرات التي تقوم بها. قد تؤدي التغييرات غير الصحيحة إلى توقف wis2box عن العمل.

لا تشارك محتويات ملف wis2box.env مع أي شخص، حيث يحتوي على معلومات حساسة مثل كلمات المرور.

بدء تشغيل wis2box

تأكد من أنك في الدليل الذي يحتوي على ملفات تعريف حزمة برامج wis2box:

cd ~/wis2box

ابدأ تشغيل wis2box باستخدام الأمر التالي:

python3 wis2box-ctl.py start

عند تشغيل هذا الأمر لأول مرة، سترى الإخراج التالي:

No docker-compose.images-*.yml files found, creating one
Current version=Undefined, latest version=1.2.0
Would you like to update ? (y/n/exit)

اختر y وسيقوم السكربت بإنشاء الملف docker-compose.images-1.2.0.yml، وتنزيل صور Docker المطلوبة وبدء الخدمات.

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

تحقق من الحالة باستخدام الأمر التالي:

python3 wis2box-ctl.py status

كرر هذا الأمر حتى تكون جميع الخدمات قيد التشغيل.

wis2box و Docker

يعمل wis2box كمجموعة من حاويات Docker التي يتم إدارتها بواسطة docker-compose.

يتم تعريف الخدمات في ملفات docker-compose*.yml المختلفة التي يمكن العثور عليها في دليل ~/wis2box/.

يتم استخدام سكربت Python wis2box-ctl.py لتشغيل أوامر Docker Compose الأساسية التي تتحكم في خدمات wis2box.

لا تحتاج إلى معرفة تفاصيل حاويات Docker لتشغيل حزمة برامج wis2box، ولكن يمكنك استعراض ملفات docker-compose*.yml لمعرفة كيفية تعريف الخدمات. إذا كنت مهتمًا بمعرفة المزيد عن Docker، يمكنك العثور على مزيد من المعلومات في وثائق Docker.

لتسجيل الدخول إلى حاوية wis2box-management، استخدم الأمر التالي:

python3 wis2box-ctl.py login

لاحظ أنه بعد تسجيل الدخول، سيتغير الموجه الخاص بك، مما يشير إلى أنك الآن داخل حاوية wis2box-management:

root@025381da3c40:/home/wis2box#

داخل حاوية wis2box-management، يمكنك تشغيل أوامر مختلفة لإدارة wis2box الخاص بك، مثل:

  • wis2box auth add-token --path processes/wis2box : لإنشاء رمز تفويض لنقطة النهاية processes/wis2box
  • wis2box data clean --days=<number-of-days> : لتنظيف البيانات الأقدم من عدد معين من الأيام من حاوية wis2box-public

للخروج من الحاوية والعودة إلى جهازك المضيف، استخدم الأمر التالي:

exit

قم بتشغيل الأمر التالي لرؤية حاويات Docker التي تعمل على جهازك المضيف:

docker ps --format "table {{.Names}} \t{{.Status}} \t{{.Image}}"

يجب أن ترى الحاويات التالية قيد التشغيل:

NAMES                     STATUS                   IMAGE
elasticsearch            docker.elastic.co/elasticsearch/elasticsearch:8.6.2                              "/bin/tini -- /usr/l…"   elasticsearch            منذ حوالي دقيقة   قيد التشغيل منذ حوالي دقيقة (سليم)     9200/tcp, 9300/tcp
elasticsearch-exporter   quay.io/prometheuscommunity/elasticsearch-exporter:latest                        "/bin/elasticsearch_…"   elasticsearch-exporter   منذ حوالي دقيقة   قيد التشغيل منذ حوالي دقيقة               7979/tcp
grafana                  grafana/grafana-oss:9.0.3                                                        "/run.sh"                grafana                  منذ حوالي دقيقة   قيد التشغيل منذ حوالي دقيقة               0.0.0.0:3000->3000/tcp
loki                     grafana/loki:2.4.1                                                               "/usr/bin/loki -conf…"   loki                     منذ حوالي دقيقة   قيد التشغيل منذ حوالي دقيقة               3100/tcp
mosquitto                ghcr.io/world-meteorological-organization/wis2box-broker:1.2.0                   "/docker-entrypoint.…"   mosquitto                منذ حوالي دقيقة   قيد التشغيل منذ حوالي دقيقة               0.0.0.0:1883->1883/tcp, 0.0.0.0:8884->8884/tcp
mqtt_metrics_collector   ghcr.io/world-meteorological-organization/wis2box-mqtt-metrics-collector:1.2.0   "python3 -u mqtt_met…"   mqtt_metrics_collector   منذ حوالي دقيقة   قيد التشغيل منذ 10 ثوانٍ                   8000/tcp, 0.0.0.0:8001->8001/tcp
nginx                    nginx:alpine                                                                     "/docker-entrypoint.…"   web-proxy                منذ حوالي دقيقة   قيد التشغيل منذ 9 ثوانٍ                    0.0.0.0:80->80/tcp
prometheus               prom/prometheus:v2.37.0                                                          "/bin/prometheus --c…"   prometheus               منذ حوالي دقيقة   قيد التشغيل منذ حوالي دقيقة               9090/tcp
wis2box-api              ghcr.io/world-meteorological-organization/wis2box-api:1.2.0                      "/app/docker/es-entr…"   wis2box-api              منذ حوالي دقيقة   قيد التشغيل منذ 36 ثانية (سليم)         
wis2box-auth             ghcr.io/world-meteorological-organization/wis2box-auth:1.2.0                     "/entrypoint.sh"         wis2box-auth             منذ حوالي دقيقة   قيد التشغيل منذ 10 ثوانٍ                   
wis2box-management       ghcr.io/world-meteorological-organization/wis2box-management:1.2.0               "/home/wis2box/entry…"   wis2box-management       منذ حوالي دقيقة   قيد التشغيل منذ 12 ثانية                   
wis2box-minio            minio/minio:RELEASE.2024-08-03T04-33-23Z-cpuv1                                   "/usr/bin/docker-ent…"   minio                    منذ حوالي دقيقة   قيد التشغيل منذ حوالي دقيقة (سليم)     0.0.0.0:8022->8022/tcp, 0.0.0.0:9000-9001->9000-9001/tcp
wis2box-ui               ghcr.io/world-meteorological-organization/wis2box-ui:1.2.0                       "/docker-entrypoint.…"   wis2box-ui               منذ حوالي دقيقة   قيد التشغيل منذ 35 ثانية                   0.0.0.0:9999->80/tcp
wis2box-webapp           ghcr.io/world-meteorological-organization/wis2box-webapp:1.2.0                   "sh /wis2box-webapp/…"   wis2box-webapp           منذ حوالي دقيقة   قيد التشغيل منذ حوالي دقيقة (غير سليم)   4173/tcp
wis2downloader           ghcr.io/wmo-im/wis2downloader:v0.3.2                                             "/home/wis2downloade…"   wis2downloader           منذ حوالي دقيقة   قيد التشغيل منذ حوالي دقيقة (سليم)

تُعد هذه الحاويات جزءًا من حزمة برامج wis2box وتوفر الخدمات المختلفة المطلوبة لتشغيل wis2box.

قم بتشغيل الأمر التالي لرؤية وحدات التخزين (volumes) الخاصة بـ Docker التي تعمل على جهازك المضيف:

docker volume ls

يجب أن ترى وحدات التخزين التالية:

  • wis2box_project_auth-data
  • wis2box_project_es-data
  • wis2box_project_minio-data
  • wis2box_project_prometheus-data
  • wis2box_project_loki-data
  • wis2box_project_mosquitto-config

بالإضافة إلى بعض وحدات التخزين المجهولة التي تُستخدم بواسطة الحاويات المختلفة.

تُستخدم وحدات التخزين التي تبدأ بـ wis2box_project_ لتخزين البيانات الدائمة للخدمات المختلفة في حزمة برامج wis2box.

واجهة برمجة تطبيقات wis2box

تحتوي wis2box على واجهة برمجة تطبيقات (API) توفر الوصول إلى البيانات والعمليات للتصور التفاعلي وتحويل البيانات والنشر.

افتح علامة تبويب جديدة وانتقل إلى الصفحة http://YOUR-HOST/oapi.

wis2box-api.png

هذه هي الصفحة الرئيسية لواجهة برمجة تطبيقات wis2box (تعمل عبر الحاوية wis2box-api).

Question

ما هي المجموعات المتوفرة حاليًا؟

اضغط لعرض الإجابة

لعرض المجموعات المتوفرة حاليًا عبر واجهة برمجة التطبيقات، اضغط على View the collections in this service:

wis2box-api-collections.png

المجموعات التالية متوفرة حاليًا:

  • المحطات
  • إشعارات البيانات
  • بيانات وصفية للاكتشاف

Question

كم عدد إشعارات البيانات التي تم نشرها؟

اضغط لعرض الإجابة

اضغط على "إشعارات البيانات"، ثم اضغط على Browse through the items of "Data Notifications".

ستلاحظ أن الصفحة تقول "No items" حيث لم يتم نشر أي إشعارات بيانات حتى الآن.

تطبيق wis2box-webapp

افتح متصفح الويب وانتقل إلى الصفحة http://YOUR-HOST/wis2box-webapp.

ستظهر نافذة منبثقة تطلب اسم المستخدم وكلمة المرور الخاصة بك. استخدم اسم المستخدم الافتراضي wis2box-user وكلمة المرور WIS2BOX_WEBAPP_PASSWORD المحددة في ملف wis2box.env واضغط على "تسجيل الدخول":

Note

تحقق من ملف wis2box.env للحصول على قيمة WIS2BOX_WEBAPP_PASSWORD. يمكنك استخدام الأمر التالي للتحقق من قيمة هذا المتغير البيئي:

cat ~/wis2box/wis2box.env | grep WIS2BOX_WEBAPP_PASSWORD

بمجرد تسجيل الدخول، حرّك مؤشر الفأرة إلى القائمة الموجودة على اليسار لرؤية الخيارات المتاحة في تطبيق wis2box:

wis2box-webapp-menu.png

هذا هو تطبيق wis2box الذي يتيح لك التفاعل مع wis2box الخاص بك:

  • إنشاء وإدارة مجموعات البيانات
  • تحديث/مراجعة بيانات المحطات الوصفية
  • تحميل الملاحظات اليدوية باستخدام نموذج FM-12 synop
  • مراقبة الإشعارات المنشورة على wis2box-broker

سنستخدم هذا التطبيق في جلسة لاحقة.

wis2box-broker

افتح تطبيق MQTT Explorer على جهاز الكمبيوتر الخاص بك وقم بإعداد اتصال جديد للاتصال بالوسيط الخاص بك (يعمل عبر الحاوية wis2box-broker).

اضغط على + لإضافة اتصال جديد:

mqtt-explorer-new-connection.png

يمكنك الضغط على زر 'ADVANCED' والتحقق من أنك مشترك في المواضيع التالية:

  • #
  • $SYS/#

mqtt-explorer-topics.png

Note

الموضوع # هو اشتراك عام يقوم بالاشتراك في جميع المواضيع المنشورة على الوسيط.

الرسائل المنشورة تحت الموضوع $SYS هي رسائل نظام يتم نشرها بواسطة خدمة mosquitto نفسها.

استخدم تفاصيل الاتصال التالية، مع التأكد من استبدال قيمة <your-host> باسم المضيف الخاص بك وقيمة <WIS2BOX_BROKER_PASSWORD> بالقيمة الموجودة في ملف wis2box.env:

  • البروتوكول: mqtt://
  • المضيف: <your-host>
  • المنفذ: 1883
  • اسم المستخدم: wis2box
  • كلمة المرور: <WIS2BOX_BROKER_PASSWORD>

Note

يمكنك التحقق من ملف wis2box.env للحصول على قيمة WIS2BOX_BROKER_PASSWORD. يمكنك استخدام الأمر التالي للتحقق من قيمة هذا المتغير البيئي:

cat ~/wis2box/wis2box.env | grep WIS2BOX_BROKER_PASSWORD

لاحظ أن هذه هي كلمة المرور الداخلية الخاصة بالوسيط، وسيستخدم الوسيط العالمي بيانات اعتماد مختلفة (للقراءة فقط) للاشتراك في الوسيط الخاص بك. لا تشارك هذه الكلمة مع أي شخص.

تأكد من الضغط على "SAVE" لحفظ تفاصيل الاتصال الخاصة بك.

ثم اضغط على "CONNECT" للاتصال بـ wis2box-broker.

mqtt-explorer-wis2box-broker.png

بمجرد الاتصال، تحقق من أن إحصائيات mosquitto الداخلية يتم نشرها بواسطة الوسيط الخاص بك تحت الموضوع $SYS:

mqtt-explorer-sys-topic.png

احتفظ بـ MQTT Explorer مفتوحًا، حيث سنستخدمه لمراقبة الرسائل المنشورة على الوسيط.

الخاتمة

تهانينا!

في هذه الجلسة العملية، تعلمت كيفية:

  • تشغيل سكربت wis2box-create-config.py لإنشاء التكوين الأولي
  • بدء تشغيل wis2box والتحقق من حالة مكوناته
  • الوصول إلى wis2box-webapp و wis2box-API في المتصفح
  • الاتصال بوسيط MQTT على جهاز الطالب الافتراضي الخاص بك باستخدام MQTT Explorer