CShark программасын орнотуу боюнча нускамалар

Берилген инстанцияны аныктоо

1. Документтин максаты

Документ CShark программасын кантип жайылтуу керектигин белгилейт. Көрсөтмөлөр колдонуучуга өз алдынча:

1. эсептөө чөйрөсүнүн системалык талаптарга шайкештигин текшерүү;
2. аныкталган жеткирүү топтомун алуу;
3. анын бүтүндүгүн текшерүү;
4. автоматташтырылган орнотууну жүзөгө ашыруу;
5. негизги мүмкүндүк алуу грамоталарын алуу;
6. контролдук мүнөздөмөлөрдү колдонуу менен инстанциянын иштешин ырастоо.

Көрсөтмөлөр вариантта берилген көчүрмөгө шилтеме кылат demo Ubuntu Server 24.04 LTS AMD64 үчүн. Орнотуудан кийин «Түндүк» демо-паркингинин жасалма объектиси юридикалык жактын реалдуу дареги жана реквизиттерисиз автоматтык түрдө түзүлөт: бир деңгээл, эки зоналар жана 50 унаа токтотуучу жай. Стандарттык Device Gateway, жасалма 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. OS жана 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

Веб-интерфейсте кирүү терезеси, диаграмма, инциденттер, журнал, аналитика, жандуу абал, жабдуулар, табло жана административдик функциялар кирген колдонуучунун укуктарына ылайык жеткиликтүү болушу керек.

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 OS жана x86_64 архитектурасы тастыкталган.
• RAM жана бош диск мейкиндигинин көлөмү талаптарга жооп берет.
• Берилген комплекттин SHA-256 нускамаларына дал келет.
• Орнотуучу код менен чыкты 0.
• Түтүн сыноодон өттү.
• Негизги маалыматтар алынды.
• API /api/health жооптор.
• Веб интерфейси колдонуучунун жумушчу станциясынан жеткиликтүү.
• Демо паркинг "Түндүк" түзүлдү, эки зонасы жана так 50 орун.
• Жалган APS иштеп жатат жана жайгашкан жердин абалынын өзгөрүшү системада көрсөтүлөт.
• Медиа пакетти туташтыруудан мурун эч кандай реалдуу жээкчелер жок экенин ырастады.
• Комментарийлер болсо, орнотуу журналдары сакталат.