إعداد مجموعة بيانات موصى بها

نتائج التعلم

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

• إنشاء مجموعة بيانات جديدة بسياسة بيانات 'موصى بها'
• إضافة رمز وصول إلى مجموعة البيانات
• التحقق من أن مجموعة البيانات لا يمكن الوصول إليها بدون رمز الوصول
• إضافة رمز الوصول إلى رؤوس HTTP للوصول إلى مجموعة البيانات
• إضافة ملف ترخيص مخصص مستضاف على مثيل wis2box الخاص بك

المقدمة

تتم مشاركة البيانات على WIS2 وفقًا لسياسة البيانات الموحدة لـ WMO التي تحدد فئتين من البيانات.

أساسية: البيانات التي يتم توفيرها مجانًا وبدون قيود، بدون رسوم وبدون شروط على الاستخدام.

موصى بها: البيانات التي قد يتم توفيرها بشروط على الاستخدام و/أو تخضع لترخيص.

البيانات التي يتم مشاركتها كموصى بها:

• قد تكون خاضعة لشروط على الاستخدام وإعادة الاستخدام.
• قد يتم تطبيق ضوابط الوصول على البيانات.
• لا يتم تخزينها مؤقتًا بواسطة WIS2 Global Caches.
• يجب أن تحتوي على سجل بيانات وصفية يتضمن عنوان URL للترخيص.

تنزيل البيانات الموصى بها

نظرًا لأن WIS Global Caches لا تخزن البيانات الموصى بها مؤقتًا، فلن ترى إشعارات على الموضوع cache/a/wis2/<centre-id>/data/recommended/..

يجب على مستهلك البيانات تنزيل البيانات من خادم البيانات المستضاف بواسطة مزود البيانات، باستخدام عنوان URL الأساسي المقدم في الإشعارات على الموضوع origin/a/wis2/<centre-id>/data/recommended/...

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

بيانات الطيران في WIS2

في هذا التمرين، يُطلب منك إنشاء مجموعة بيانات لمشاركة بيانات METAR، وهو تنسيق قياسي للإبلاغ عن ملاحظات الطقس للطيران.

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

لمزيد من المعلومات، راجع القسم الخاص بنشر بيانات الأرصاد الجوية للطيران في دليل WIS2.

التحضير

تأكد من أن لديك وصول SSH إلى جهاز الطالب الافتراضي الخاص بك وأن مثيل wis2box الخاص بك يعمل.

تأكد من أنك متصل بوسيط MQTT الخاص بمثيل wis2box الخاص بك باستخدام MQTT Explorer. يمكنك استخدام بيانات الاعتماد العامة everyone/everyone للاتصال بالوسيط.

تأكد من فتح متصفح ويب مع تطبيق wis2box-webapp لمثيلك عن طريق الانتقال إلى http://YOUR-HOST/wis2box-webapp.

إنشاء مجموعة بيانات جديدة بسياسة بيانات 'موصى بها'

انتقل إلى صفحة 'محرر مجموعة البيانات' في wis2box-webapp وقم بإنشاء مجموعة بيانات جديدة.

بالنسبة لـ "Centre ID"، استخدم نفس المعرف الذي استخدمته في الجلسات العملية السابقة.

حدد القالب = 'other' للإشارة إلى أنك لن تستخدم قالبًا محددًا مسبقًا لمجموعة البيانات:

انقر على 'CONTINUE TO FORM' للمتابعة.

بالنسبة لهذا التمرين، يرجى إنشاء مجموعة بيانات لبيانات الطيران METAR؛

• اختر معرفًا محليًا مناسبًا لمجموعة البيانات، على سبيل المثال 'aviation-metar'
• قدم عنوانًا ووصفًا لمجموعة البيانات
• اختر سياسة بيانات WMO = 'موصى بها'

لاحظ أنه عند اختيار سياسة بيانات WMO = 'موصى بها'، أضاف محرر مجموعة البيانات تلقائيًا حقلًا لـ 'License URL' وهو إلزامي لمجموعات البيانات الموصى بها.

التالي:

• استخدم WIS2BOX_URL/data/aviation-license.html للإشارة إلى ملف ترخيص مخصص مستضاف على مثيلك، مع استبدال WIS2BOX_URL بعنوان URL الخاص بمثيل wis2box الخاص بك.
• اختر 'Sub Disciple Topic' = 'aviation/metar' لتعريف الموضوع الصحيح لهذه المجموعة.

حول عنوان URL للترخيص

عنوان URL للترخيص المرتبط بمجموعة بيانات موصى بها يُعلم مستهلكي البيانات لهذه المجموعة عن شروط استخدام البيانات.

يمكنك استخدام عنوان URL يشير إلى ملف ترخيص مستضاف على مثيل wis2box الخاص بك، أو يمكنك استخدام عنوان URL يشير إلى ملف ترخيص مستضاف على موقع ويب خارجي.

بالنسبة لهذا التمرين، سنستخدم ملف ترخيص مستضاف ذاتيًا. ستضيف الملف 'aviation-license.html' إلى مثيل wis2box الخاص بك لاحقًا في هذه الجلسة العملية لضمان صلاحية عنوان URL للترخيص.

نظرًا لأنك اخترت القالب = 'other'، لم يتم ملء الكلمات الرئيسية مسبقًا لمجموعة البيانات. أضف ما لا يقل عن 3 كلمات رئيسية ذات صلة بمجموعة البيانات:

تابع لملء الحقول المطلوبة لخصائص المكان ومعلومات الاتصال. انقر على 'Validate form' للتحقق من أن جميع الحقول الإلزامية قد تم ملؤها.

نظرًا لأنك اخترت القالب = 'other'، لم يتم تعريف خرائط مجموعة البيانات.

يرجى إضافة المكون الإضافي لـ 'Universal data without conversion' والتأكد من تعيين امتداد الملف إلى .txt ليتوافق مع ملفات بيانات METAR التي ستنشرها إلى هذه المجموعة لاحقًا في هذه الجلسة العملية:

قم بإرسال مجموعة البيانات، باستخدام رمز المصادقة الذي تم إنشاؤه مسبقًا، وتحقق من إنشاء مجموعة البيانات الجديدة في wis2box-webapp.

تحقق من MQTT Explorer للتحقق من أنك تتلقى رسالة إشعار WIS2 تعلن عن سجل البيانات الوصفية الجديد على الموضوع origin/a/wis2/<your-centre-id>/metadata.

مراجعة مجموعة البيانات الجديدة في wis2box-api

عرض قائمة مجموعات البيانات في wis2box-api عن طريق فتح عنوان URL WIS2BOX_URL/oapi/collections/discovery-metadata/items في متصفح الويب الخاص بك، مع استبدال WIS2BOX_URL بعنوان URL الخاص بمثيل wis2box الخاص بك.

افتح رابط مجموعة البيانات التي تم إنشاؤها للتو وانتقل إلى قسم 'links' في استجابة JSON:

يجب أن ترى رابطًا لـ "License for this dataset" يشير إلى عنوان URL المقدم في محرر مجموعة البيانات.

إذا نقرت على الرابط، ستظهر لك رسالة خطأ لأن ملف الترخيص لم تتم إضافته بعد إلى مثيل wis2box الخاص بك.

إضافة ملف الترخيص إلى مثيل wis2box الخاص بك

تأكد من أن الرابط لـ "License for this dataset" في البيانات الوصفية لمجموعة البيانات الموصى بها يعمل كما هو متوقع.

قم بتنزيل ملف الترخيص للطيران كمثال: aviation-license.html.

حول ملف الترخيص للطيران كمثال

هذا مثال لملف ترخيص لبيانات الطيران. قد ترغب في تعديل الملف لتضمين معلومات ذات صلة بمؤسستك.

لتحميل هذا الملف، استخدم وحدة التحكم MinIO المتوفرة على المنفذ 9001 لمثيل wis2box، عن طريق الانتقال إلى متصفح الويب وزيارة http://YOUR-HOST:9001.

بيانات الاعتماد للوصول إلى وحدة التحكم MinIO في ملف wis2box.env يتم تعريفها بواسطة متغيرات البيئة WIS2BOX_STORAGE_USERNAME و WIS2BOX_STORAGE_PASSWORD.

يمكنك العثور عليها في ملف wis2box.env كما يلي:

cat wis2box.env | grep WIS2BOX_STORAGE_USERNAME
cat wis2box.env | grep WIS2BOX_STORAGE_PASSWORD

بمجرد تسجيل الدخول إلى وحدة التحكم MinIO، قم بتحميل ملف الترخيص إلى المسار الأساسي لدلو wis2box-public باستخدام زر "Upload":

بعد تحميل ملف الترخيص، تحقق من إمكانية الوصول إلى الملف عن طريق زيارة WIS2BOX_URL/data/aviation-license.html في متصفح الويب الخاص بك، مع استبدال WIS2BOX_URL بعنوان URL الخاص بمثيل wis2box الخاص بك.

Note

يقوم الوكيل في wis2box بتمرير جميع الملفات المخزنة في دلو "wis2box-public" تحت المسار WIS2BOX_URL/data/.

الرابط لـ "License for this dataset" المدرج في البيانات الوصفية لمجموعة البيانات الموصى بها يجب أن يعمل الآن كما هو متوقع.

إضافة رمز وصول إلى مجموعة البيانات

قم بتسجيل الدخول إلى حاوية wis2box-management،

cd ~/wis2box
python3 wis2box-ctl.py login

من سطر الأوامر داخل الحاوية يمكنك تأمين مجموعة بيانات باستخدام الأمر wis2box auth add-token، باستخدام العلم --metadata-id لتحديد معرف البيانات الوصفية لمجموعة البيانات ورمز الوصول كوسيطة.

على سبيل المثال، لإضافة رمز الوصول S3cr3tT0k3n إلى مجموعة البيانات بمعرف البيانات الوصفية urn:wmo:md:my-centre-id:core.surface-based-observations.synop:

wis2box auth add-token --metadata-id urn:wmo:md:my-centre-id:aviation-metar S3cr3tT0k3n

اخرج من حاوية wis2box-management:

exit

نشر بعض البيانات إلى مجموعة البيانات

قم بتنزيل ملف بيانات METAR كمثال إلى جهازك المحلي:

A_SAKO31RKSL290000_C_RKSL_20250729000055.txt

ثم قم بإدخال هذا الملف في مجموعة البيانات الخاصة بك باستخدام MinIO Console. للوصول إلى MinIO Console، افتح متصفح الويب وقم بزيارة http://YOUR-HOST:9001 وقم بتسجيل الدخول باستخدام بيانات الاعتماد المحددة في ملف wis2box.env بواسطة متغيرات البيئة WIS2BOX_STORAGE_USERNAME و WIS2BOX_STORAGE_PASSWORD.

لإدخال الملف في مجموعة البيانات الخاصة بك، انتقل إلى الحاوية wis2box-incoming وقم بإنشاء مجلد جديد باسم معرف البيانات الوصفية الخاص بمجموعة البيانات الخاصة بك وقم برفع ملف بيانات METAR المثال إلى هذا المجلد باستخدام زر “Upload”:

تأكد من أن اسم المجلد يساوي معرف البيانات الوصفية لمجموعة البيانات الخاصة بك وتحقق من أنك تتلقى إشعارات بيانات WIS2 في MQTT Explorer، على الموضوع origin/a/wis2/<your-centre-id>/data/recommended/aviation/metar:

استكشاف الأخطاء وإصلاحها

إذا لم تتلق إشعارًا بعد رفع البيانات، يمكنك التحقق من السجلات الأخيرة لحاوية wis2box-management لاستكشاف المشكلة:

docker logs -n100 wis2box-management

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

http://example.wis2.training/data/2025-07-29/wis/urn:wmo:md:int-wmo-example:aviation-metar/A_SAKO31RKSL290000_C_RKSL_20250729000055.txt

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

إضافة رمز الوصول إلى رؤوس HTTP للوصول إلى مجموعة البيانات

لإثبات أن رمز الوصول مطلوب للوصول إلى مجموعة البيانات، سنعيد إنتاج الخطأ الذي رأيته في المتصفح باستخدام وظيفة سطر الأوامر wget.

من سطر الأوامر في جهاز الطالب الخاص بك، استخدم أمر wget مع الرابط الكنسي الذي نسخته من رسالة إشعار WIS2.

wget http://example.wis2.training/data/2025-07-29/wis/urn:wmo:md:int-wmo-example:aviation-metar/A_SAKO31RKSL290000_C_RKSL_20250729000055.txt

يجب أن ترى أن طلب HTTP يعود بـ 401 Unauthorized وأن البيانات لم يتم تنزيلها.

الآن قم بإضافة رمز الوصول إلى رؤوس HTTP للوصول إلى مجموعة البيانات.

wget --header="Authorization: Bearer S3cr3tT0k3n" <canonical-link>

الآن يجب أن يتم تنزيل البيانات بنجاح.

إزالة رمز الوصول من مجموعة البيانات

لإزالة رمز الوصول من مجموعة البيانات، قم بتسجيل الدخول إلى حاوية wis2box-management،

cd ~/wis2box
python3 wis2box-ctl.py login

واستخدم الأمر wis2box auth remove-token لإزالة رمز الوصول من مجموعة البيانات، باستخدام العلم --metadata-id لتحديد معرف البيانات الوصفية لمجموعة البيانات ورمز الوصول كوسيطة:

wis2box auth remove-token --metadata-id urn:wmo:md:my-centre-id:aviation-metar S3cr3tT0k3n

تأكد من استبدال urn:wmo:md:my-centre-id:aviation-metar بمعرف البيانات الوصفية لمجموعة البيانات الخاصة بك.

قم بتسجيل الخروج من حاوية wis2box-management:

exit

وتحقق من أن رمز الوصول قد تم إزالته عن طريق محاولة تنزيل البيانات مرة أخرى باستخدام wget مع رمز الوصول في رؤوس HTTP، أو عن طريق محاولة الوصول إلى البيانات في متصفح الويب الخاص بك.

التحكم في الوصول اختياري، فقط للمجموعات الموصى بها

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

إذا قمت بتطبيق wis2box auth add-token على مجموعة بيانات بسياسة بيانات WMO 'core'، ستقوم Global Caches بالإبلاغ عن خطأ إلى Global Monitoring لأنها لا تستطيع تنزيل البيانات وستعتبر مجموعة البيانات الخاصة بك غير متوافقة مع اللوائح الفنية لـ WIS2.

الخلاصة

تهانينا!

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

• إنشاء مجموعة بيانات جديدة بسياسة بيانات 'موصى بها'
• إضافة ملف ترخيص مخصص إلى مثيل wis2box الخاص بك
• إضافة رمز وصول إلى مجموعة البيانات
• التحقق من أن مجموعة البيانات لا يمكن الوصول إليها بدون رمز الوصول
• إضافة رمز الوصول إلى رؤوس HTTP للوصول إلى مجموعة البيانات