تُرجمت هذه الوثيقة آليًا من الإنجليزية باستخدام Claude AI. ينبغي مراجعة المصطلحات المتعلقة بمجال WMO/الأرصاد الجوية من قِبل متحدث أصلي قبل الاستخدام الإنتاجي. راجع النسخة الإنجليزية الأصلية للاطلاع على النسخة المرجعية.

ابدأ تشغيل WIS2 Downloader وتنزيل بياناتك الأولى في غضون دقائق.

المتطلبات الأساسية

  • Docker 20.10+

  • Docker Compose 2.0+

  • اتصال شبكي بـ Global Broker الخاص بـ WIS2 (المنفذ 443)

1. التنزيل والاستخراج

نزّل أرشيف أحدث إصدار واستخرج محتوياته:

tar -xzf wis2downloader-*.tar.gz
cd wis2downloader-*
للمتابعة مع أحدث إصدار تطويري، استنسخ المستودع: git clone https://github.com/World-Meteorological-Organization/wis2downloader.git

2. التهيئة

شغّل سكريبت الإعداد لإنشاء ملف .env بمفاتيح سرية عشوائية:

bash setup.sh

يقوم هذا السكريبت بنسخ default.env إلى .env وتوليد قيم عشوائية لـ FLASK_SECRET_KEY و`REDIS_PASSWORD`. راجع ملف .env وعدّل الإعدادات إذا لزم الأمر — القيم الافتراضية مناسبة للنشر على جهاز واحد.

احتفظ بملف .env في مكان آمن. يحتوي على بيانات اعتماد حساسة ويجب عدم إدراجه في نظام إدارة الإصدارات.

3. إعداد مجلد التنزيلات

تعمل الحاويات بصلاحيات مستخدم غير جذري (UID 10001، GID 988). على نظام Linux، يجب إعداد مجلد التنزيلات قبل البدء:

sudo groupadd -g 988 wis2
sudo useradd -u 10001 -g wis2 -M -s /usr/sbin/nologin wis2
mkdir -p downloads
sudo chown wis2:wis2 downloads
على نظامَي macOS وWindows (Docker Desktop)، هذه الخطوة غير مطلوبة — يتولى Docker Desktop إدارة صلاحيات الأحجام تلقائيًا.

إن تعذّر عليك إنشاء مستخدم مطابق، راجع قسم صلاحيات الأحجام في دليل الإدارة للاطلاع على البدائل المستندة إلى ACL.

4. تشغيل الخدمات

docker compose up -d

يُشغّل هذا الأمر جميع الخدمات: مدير الاشتراكات، مشتركو MQTT (Global Brokers لفرنسا والبرازيل)، عمّال Celery للتنزيل، Redis، Prometheus، Grafana، وLoki.

تحقق من تشغيل جميع الخدمات:

docker compose ps

انتظر حتى يجتاز subscription-manager فحص الصحة (نحو 30 ثانية)، ثم تأكد من تشغيله:

curl http://localhost:5002/health

5. إنشاء اشتراك

عبر واجهة الويب (موصى به)

افتح http://localhost:8080 في متصفحك.

استخدم عرض الكتالوج أو عرض الشجرة لاستعراض مجموعات بيانات WIS2 المتاحة، واختر موضوعًا، وحدد مجلد الحفظ، ثم انقر على اشتراك.

عبر API

curl -X POST http://localhost:5002/subscriptions \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "cache/a/wis2/+/data/core/weather/surface-based-observations/#",
    "target": "surface-obs"
  }'

يُنشئ هذا اشتراكًا بجميع رصد السطح من أي مركز بيانات ويحفظ الملفات في downloads/surface-obs/.

6. عرض التنزيلات

تظهر الملفات في مجلد downloads/ مرتّبةً حسب التاريخ:

ls -la downloads/surface-obs/

راقب نشاط التنزيل في Grafana على http://localhost:3000 (بيانات الاعتماد الافتراضية: admin / admin).

غيّر كلمة المرور الافتراضية لـ Grafana بعد تسجيل الدخول الأول.

الخطوات التالية

الدليل المحتوى

دليل المستخدم

استخدام واجهة الويب، إنشاء الاشتراكات وإدارتها، تصفية البيانات

دليل الإدارة

تعزيز الأمان، التوسع، متغيرات البيئة، المراقبة، الصيانة

مرجع API

توثيق REST API الكامل؛ واجهة Swagger التفاعلية على http://localhost:5002/swagger

دليل المطور

البنية المعمارية، المكونات الداخلية، توسعة النظام