CShark Көрсетілім
Мәзір

CShark құжаттамасы

CShark бағдарламалық құралын орнату нұсқаулары

Берілген CShark данасын қолдану және оның функционалдығын тексеру жолы.

2.0.3 нұсқасы

Ағым қосулы .

Қамтамасыз етілген дананы анықтау

Берілген CShark данасына арналған опциялар
ПараметрМағынасы
Шығару нұсқасы2.0.3
Толық дереккөз міндеттемесі399717d1ed4c0e83e00150912a2a029eaec5c736
Жабдықтау арнасыstable
SHA-256 ашық кілт0908f56ddcd6cd13fe95d81faae6543b9c5953937b164fb2c487eb00a5b8921d

1. Құжаттың мақсаты

Құжат CShark бағдарламалық құралын қолдану жолын белгілейді. Нұсқаулар пайдаланушыға өз бетінше жасауға мүмкіндік береді:

  1. есептеу ортасының жүйелік талаптарға сәйкестігін тексеру;
  2. анықталған жеткізу жинағын алу;
  3. оның тұтастығын тексеру;
  4. автоматтандырылған орнатуды орындау;
  5. бастапқы кіру тіркелгі деректерін алу;
  6. басқару сипаттамаларын пайдаланып дананың өнімділігін растаңыз.

Нұсқаулар опциядағы берілген көшірмеге сілтеме жасайды demo Ubuntu сервері 24.04 LTS AMD64 үшін. Орнатқаннан кейін «Солтүстік» демо-паркингінің жалған нысаны заңды тұлғаның нақты мекенжайынсыз және деректемелерінсіз автоматты түрде жасалады: бір деңгей, екі аймақ және 50 тұрақ орны. Жинаққа стандартты құрылғы шлюзі, жалған APS және басқа қажетті эмуляторлар кіреді.

2. Жеткізу жиынтығын анықтау

CShark бумасының мазмұны мен идентификаторлары
ПараметрМағынасы
Бағдарламалық құрал атауыCShark
Дана идентификаторы2.0.3 / 399717d1ed4c0e83e00150912a2a029eaec5c736
Деректер опциясыdemo, seed 2026.07.2, 50 орын
Демонстрациялық объектНақты мекенжайы және заңды тұлғасы жоқ «Северный» автотұрағы
Мақсатты ОЖUbuntu Server 24.04 LTS
СәулетAMD64 / x86_64
Толық жиын атауыcshark-2.0.3-demo-ubuntu-24.04-amd64-offline.tar
SHA-256 толық жиынтығыccb36a121bf8e1b756f1190f9369e490585082417829458b9bc62108620850c6
Жинақты алу тәртібісұрауы бойынша авторлық құқық иесі береді
Жабдықтау арнасыstable
Әдепкі орнату каталогы/opt/cshark-stand
Әдепкі құрастыру жобасыcshark-stand

3. Жүйе талаптары

3.1. Сервер

Ең аз және ұсынылған сервер конфигурациясы
ПараметрЕң төменгі талапҰсынылатын конфигурация
Қоршаған ортаның түрібөлек таза VM немесе физикалық сервербасқа қолданба қызметтерінсіз бөлек VM
Операциялық жүйеUbuntu Server 24.04 LTSағымдағы Ubuntu сервері 24.04 LTS
СәулетAMD64 / x86_64AMD64 / x86_64
CPUкемінде 4 vCPU4-8 vCPU
ЖЖҚкемінде 8 ГБ16 ГБ
Бос дискілік кеңістіккемінде 30 ГБSSD дискісінде 50 ГБ бастап
Жүйе уақытыдұрыс күн, уақыт және уақыт белдеуіNTP синхрондауы
Құқықтарsudo бар пайдаланушыбөлек әкімші тіркелгісі

3.2. Желіге кіру

Берілген жинақтан серверге орнату үшін сізге қажет:

  • стандартты командалар bash, tar, sha256sum, awk, find, hostname.

Docker Engine, Docker Compose v2, containerd, Python, OpenSSL және басқа жұмыс уақытына тәуелділіктер берілген жинаққа кіретін жергілікті APT репозиторийінен орнатылады. PyPI, npm немесе сыртқы Docker тізіліміне кіру қажет емес.

3.3. Дана порттары

Желі порттары және ұсынылатын қатынас
ПортМақсатҰсынылған рұқсат
8088/tcpВеб-интерфейс және APIпайдаланушы жұмыс станциясы
18333/tcpmedia/S3пайдаланушы жұмыс станциясы
13000/tcpGrafanaәкімші
18010/tcpқұрылғы оқиғаларын қабылдауқұрылғылар желісі немесе эмуляторларды жергілікті тексеру

PostgreSQL, NATS және ішкі қызметтер сыртқы түрде жарияланбайды.

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. жалған APS іске қосады;
  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

API тексеріңіз:

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

Пайдаланушының жұмыс станциясынан кіруді тексеріңіз:

Веб-интерфейс: http://<СТЕНД-IP-НЕМЕСЕ-DNS>:8088
Grafana:       http://<СТЕНД-IP-НЕМЕСЕ-DNS>:13000

Веб-интерфейсте кіру терезесі, диаграмма, оқиғалар, журнал, аналитика, тікелей күй, жабдық, табло және әкімшілік функциялар жүйеге кірген пайдаланушының құқықтарына сәйкес қолжетімді болуы керек.

8.1. Күтілетін күй демонстрациясы

  • нақты мекенжайы жоқ «Солтүстік» демо-паркингінің бір нысаны бар;
  • 1-деңгейдің бір деңгейі бар;
  • Көк сектор және Жасыл сектор аймақтары бар;
  • кодтары бар дәл 50 орын құрылды DEMO-01DEMO-50;
  • MGN, EV, мото және сервиске арналған орындар бар;
  • демонстрациялық камера, үш қақпа құрылғысы, табло және оқиға жасалды;
  • Құрылғы шлюзі және жалған APS жұмысы;
  • тұқымды қайта іске қосу көшірмелерді жасамайды;
  • Нақты камера түсірілімдері әлі қол жетімді емес және бөлек медиа бумасында қосылған.

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
Орнату хабарлары және ұсынылған әрекеттер
Хабарлама немесе қолтаңбаӘрекет
команда Ubuntu AMD64 үшін арналғанUbuntu 24.04 x86_64 пайдаланыңыз; ARM64 қолдау көрсетілмейді
бос орын жеткіліксізкемінде 30 ГБ бос орынды қамтамасыз етіңіз
TCP порты бос емеспортты босатыңыз немесе орнатушыға басқа порт беріңіз
орнату каталогы бос еместаза каталогты пайдаланыңыз; диагностикасыз деректерді жоймаңыз
қолтаңбасыз жинаққол қойылған тұрақты жинақты пайдаланыңыз; сынақ жалаушасы пайдаланылмайды
демо деректерін жүктеу сәтсіз аяқталдысақтау install.log; аттас нысанды қолмен жасамаңыз
Core қалыпты күйге өтпедісақтау install.log және контейнер журналдары

Орнату сәтсіз болса, контейнерлер тоқтатылады және диагностикалық мақсаттар үшін көлемдер сақталады. Бұрыннан бар каталог бойынша қайта орнату себебі талданбайынша орындалмайды.

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 архитектурасы расталды.
  • ЖЖҚ көлемі мен бос дискілік кеңістік талаптарға сәйкес келеді.
  • Берілген жинақтың SHA-256 нұсқаулығына сәйкес келеді.
  • Орнатушы кодпен шықты 0.
  • Түтін сынағы өтті.
  • Негізгі мәліметтер алынды.
  • API /api/health жауаптар.
  • Веб-интерфейс пайдаланушының жұмыс станциясынан қол жетімді.
  • «Солтүстік» демо-тұрағы құрылды, екі аймақ және дәл 50 орын.
  • Жалған APS жұмыс істеп тұр және жүйеде орын күйінің өзгеруі көрсетіледі.
  • Мультимедиа бумасын жалғамас бұрын нақты кадрлар жоқ екенін растады.
  • Пікірлер болса, орнату журналдары сақталады.