تعليمات تثبيت برنامج CShark

تحديد المثيل المقدم

1. الغرض من الوثيقة

تحدد الوثيقة كيفية نشر برنامج CShark. تتيح التعليمات للمستخدم القيام بما يلي بشكل مستقل:

1. التحقق من امتثال بيئة الحوسبة لمتطلبات النظام؛
2. الحصول على مجموعة أدوات التوصيل المحددة؛
3. التحقق من سلامتها.
4. إجراء التثبيت الآلي.
5. الحصول على بيانات اعتماد الوصول الأساسي؛
6. تأكيد أداء المثيل باستخدام خصائص التحكم.

تشير التعليمات إلى النسخة المتوفرة في الخيار demo لخادم Ubuntu 24.04 LTS AMD64. بعد التثبيت، يتم تلقائيًا إنشاء كائن وهمي لمواقف السيارات التجريبية "الشمالية" بدون عنوان حقيقي وتفاصيل كيان قانوني: مستوى واحد ومنطقتان و50 مكانًا لوقوف السيارات. يتم تضمين بوابة الجهاز القياسية وAPS الوهمية وغيرها من المحاكيات الضرورية في المجموعة.

2. تحديد مجموعة التسليم

3. متطلبات النظام

4. الفحص الأولي للموقف

تشغيل:

uname -m
grep -E '^(NAME|VERSION_ID)=' /etc/os-release
free -h
df -h /opt
timedatectl status

العلامات المتوقعة:

uname -m: x86_64
VERSION_ID="24.04"
RAM: 8 غيغابايت على الأقل
المساحة الحرة: 30 غيغابايت على الأقل

5. استلام عدة التسليم والتركيب

يتم توفير مجموعة التسليم - أرشيف موقّع ومفتاح التحقق من التوقيع العام وبرنامج التثبيت - من قبل صاحب حقوق الطبع والنشر عند الطلب: شركة ذات مسؤولية محدودة "KOMPETENTSIA"، الهاتف +7 495 532-61-18العنوان: 115280، موسكو، ش. لينينسكايا سلوبودا، 21 عامًا، المبنى 1. يتم التثبيت من الأرشيف المستلم بترتيب القسم 9. أمر التثبيت الأساسي (من كتالوج المجموعة غير المعبأة):

sudo ./install.sh --variant demo

لا يطالب المثبت بالعنوان العام بشكل تفاعلي. إذا كانت المعلمة --public-host لم يتم تحديده، يقوم المثبت تلقائيًا بتحديد عنوان IPv4 للخادم الأول من النتيجة hostname -I، باستثناء العناوين 127.x.x.x. إذا تعذر تحديد العنوان، فسيتوقف التثبيت ويطالبك بتكرار الأمر مع المعلمة --public-host.

إذا كان الخادم يحتوي على العديد من واجهات الشبكة، فحدد بوضوح اسم IP أو DNS الذي ستكون واجهة الويب متاحة للمستخدمين من خلاله:

sudo ./install.sh --variant demo --public-host 10.20.30.40

بدلاً من IP، يمكنك تمرير اسم DNS، على سبيل المثال --public-host cshark.example.ru. يجب أن تكون القيمة قابلة للوصول من محطات عمل المستخدم؛ وليس من الضروري أن يكون عنوانًا منشورًا على الإنترنت.

قناة stable يقبل فقط المجموعة الموقعة. العلم --allow-unsigned-testing لا تستخدم في التثبيت القياسي. المعلمة --variant demo تم اختياره بشكل صريح لأن العرض التوضيحي يحتوي على ساحة انتظار وهمية تتسع لـ 50 مكانًا. للتثبيت بدون بيانات تجريبية، استخدم نفس الأمر مع --variant clean; يتم الحفاظ على مجموعة المحاكيات.

في وقت التشغيل المثبت:

1. يتحقق من بنية نظام التشغيل وAMD64؛
2. يتحقق من SHA-256 قبل التفريغ؛
3. تثبيت Docker Engine وDocker Compose v2 وتبعيات النظام؛
4. إعادة فحص المجاميع الاختبارية الداخلية؛
5. وتنزيل صور Docker المحلية دون الوصول إلى سجل خارجي؛
6. يولد أسرار مثيل فريدة؛
7. ينشئ أدوار قاعدة بيانات منفصلة؛
8. ينطبق الهجرات.
9. يدير خدمات التطبيقات وأدوات المراقبة؛
10. يستخدم بذرة تجريبية تم إصدارها 2026.07.2;
11. يدير وكالة الأنباء الجزائرية وهمية؛
12. يقوم بإجراء اختبار الدخان التلقائي مع فحص الموقع الإلزامي.

6. معايير التثبيت الناجح

يعتبر التثبيت مكتملاً إذا تم استيفاء الشروط التالية في وقت واحد:

• خرج المثبت بالكود 0;
• تم عرض الرسالة اكتمل التثبيت بنجاح;
• تم إصدار اختبار الدخان التلقائي نجح اختبار التشغيل;
• تم إنشاء الملف /opt/cshark-stand/INITIAL-CREDENTIALS.txt;
• حاويات الملف الشخصي الرئيسية لها حالة running أو healthy;
• تُرجع واجهة برمجة التطبيقات (API) إشارة الاستعداد؛
• يتم فتح واجهة الويب من مكان عمل المستخدم؛
• يكشف اختبار الدخان عن 50 مكانًا لوقوف السيارات؛
• APS الوهمية لها حالة running أو healthy.

7. الوصول

إظهار التفاصيل الأولية:

sudo cat /opt/cshark-stand/INITIAL-CREDENTIALS.txt

فتح في المتصفح:

http://<IP-أو-DNS-للمنصة>:8088

قم بتسجيل الدخول باستخدام حساب المسؤول الأساسي الخاص بك. ملف INITIAL-CREDENTIALS.txt يحتوي على كلمة مرور المسؤول وتفاصيل Grafana. ملف العمل /opt/cshark-stand/.env يحتوي على أسرار الخدمة التي تم إنشاؤها ويتم إنشاؤها بحقوق وصول محدودة.

8. مراقبة الأداء

فحص الحاويات:

sudo docker compose \
  --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml \
  --profile obs ps

تحقق من واجهة برمجة التطبيقات:

curl -fsS http://127.0.0.1:8088/api/health

التحقق من الوصول من محطة عمل المستخدم:

واجهة الويب: http://<IP-أو-DNS-للمنصة>:8088
Grafana:       http://<IP-أو-DNS-للمنصة>:13000

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

9. التثبيت من المجموعة المتوفرة

انقل الملفات المقدمة من صاحب حقوق الطبع والنشر إلى الخادم الهدف: الأرشيف الموقع المحدد: cshark-2.0.3-demo-ubuntu-24.04-amd64-offline.tar أو cshark-2.0.3-clean-ubuntu-24.04-amd64-offline.tarبالإضافة إلى مفتاح عام موثوق به للتحقق من التوقيع.

قبل التفريغ، تحقق من SHA-256 للأرشيف المحدد:

echo 'ccb36a121bf8e1b756f1190f9369e490585082417829458b9bc62108620850c6 cshark-2.0.3-demo-ubuntu-24.04-amd64-offline.tar' | sha256sum -c -
echo 'c6e008d2e97bc8421b6b5e66abca6c861b182f4f19f7e12b3e1dd0db9f80f26b cshark-2.0.3-clean-ubuntu-24.04-amd64-offline.tar' | sha256sum -c -

بعد التحقق بنجاح، قم بفك الخيار المحدد:

mkdir -p /srv/cshark-install
tar -xf cshark-2.0.3-demo-ubuntu-24.04-amd64-offline.tar -C /srv/cshark-install
cd /srv/cshark-install/cshark-2.0.3-demo-ubuntu-24.04-amd64-offline
sudo ./install.sh \
  --public-host <IP-أو-DNS-للمنصة> \
  --trusted-public-key /المسار/cshark-release.public.pem

10. التشخيص

سجل التثبيت:

sudo cat /opt/cshark-stand/install.log

أحدث سجلات الحاويات:

sudo docker compose \
  --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml \
  --profile obs logs --no-color --tail 200

إذا لم ينجح التثبيت، يتم إيقاف الحاويات ويتم حفظ وحدات التخزين لأغراض التشخيص. لا يتم تنفيذ إعادة التثبيت على دليل موجود حتى يتم تحليل السبب.

11. توقف النظام

إيقاف مثيل دون حذف البيانات:

sudo docker compose \
  --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml \
  --profile obs down

12. قائمة التحقق من التثبيت

• تم تأكيد نظام التشغيل Ubuntu Server 24.04 LTS وبنية x86_64.
• حجم ذاكرة الوصول العشوائي (RAM) ومساحة القرص الحرة يلبي المتطلبات.
• يتوافق SHA-256 الخاص بالمجموعة المتوفرة مع التعليمات.
• خرج المثبت بالكود 0.
• اجتاز اختبار الدخان.
• تم تلقي التفاصيل الأولية.
• API /api/health إجابات.
• يمكن الوصول إلى واجهة الويب من محطة عمل المستخدم.
• تم إنشاء مواقف تجريبية "الشمالية" بمنطقتين وبسعة 50 مكانًا بالضبط.
• يتم تشغيل Mock APS ويتم عرض التغيير في حالة الموقع في النظام.
• تم التأكد من عدم وجود إطارات حقيقية قبل توصيل حزمة الوسائط.
• يتم حفظ سجلات التثبيت في حالة وجود تعليقات.