CShark Программасынын Колдонуучусу

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

Учурдагы 2026-08-06.

1. Максат

Колдонмо CShark орнотуудан кийин күнүмдүк колдонуу үчүн керектүү маалыматты камтыйт. Документ Ubuntu Server 24.04 LTS AMD64 үчүн берилген демо көчүрмөсүн билдирет.

Орнотуу өзүнчө көрсөтмөлөргө ылайык жүзөгө ашырылат. Бул окуу куралындагы буйруктар каталогду болжолдойт /opt/cshark-stand жана Долбоорду түзүү cshark-stand.

2. Иштөө шарттары

Иштөө үчүн сизге керек:

• иштеп жаткан Ubuntu Server 24.04 LTS AMD64 сервери;
• кеминде 8 ГБ оперативдүү эс жана 30 ГБ бош орун;
• туура күн, убакыт жана убакыт алкагы;
• колдонуучунун портко кирүү мүмкүнчүлүгү 8088/tcp;
• администратордун серверге коопсуз канал аркылуу кирүү мүмкүнчүлүгү;
• өндүрүш инстанциясынан бөлүнгөн резервдик сактагыч.

PostgreSQL жана NATSке тышкы мүмкүнчүлүк талап кылынбайт жана жарыяланбашы керек.

3. Баштоо жана токтотуу

Статусун текшерүү:

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

чуркоо:

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

Дайындарды жок кылбастан токтотуу:

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

4. Даярдыкты текшерүү

Ишке киргизгенден кийин, иштетиңиз:

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

Кошумча текшерүү:

• контейнерлердин абалы бар running же healthy;
• Веб интерфейси аркылуу жеткиликтүү http://<IP-ЖЕ-DNS>:8088;
• Grafana дареги боюнча жеткиликтүү http://<IP-ЖЕ-DNS>:13000;
• бош диск мейкиндиги операциялык босогодон төмөн эмес;
• сервер убактысы шайкештештирилген.

5. Биринчи кириш

Негизги маалыматтар файлда:

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

Администратор катары кириңиз жана жеке колдонуучу аккаунттарын түзүңүз. Бир нече операторлор үчүн бир жалпы эсепти колдонбоңуз: жеке жазуулар туура текшерүү үчүн зарыл.

6. Иш мейкиндиктери жана ролдор

Киргенден кийин колдонуучу ага уруксат берилген бөлүмдөрдү гана көрөт. Негизги иш мейкиндиктери:

Бөлүм жеткиликсиз болсо, администратор башка бирөөнүн аккаунтун колдонуучуга өткөрүп бербей, дайындалган ролду жана уруксаттарды текшерет.

7. Баштапкы абал демо

Орнотуудан кийин администратор текшерет:

1. "Түндүк" демо унаа токтоочу жайдын чыныгы дареги жок;
2. 1-деңгээл бар;
3. Көк сектор жана Жашыл сектор зоналары бар;
4. так 50 орун түзүлгөн DEMO-01–DEMO-50;
5. MGN, EV, мото жана сервис үчүн орундар бар;
6. демонстрациялык камера, үч дарбаза аппараты жана табло катталган;
7. Демо окуя жеткиликтүү;
8. жасалма APS абалы бар running же healthy;
9. эмулятор окуясы байланышкан жердин абалын өзгөртөт;
10. Өзүнчө медиа пакети туташканга чейин эч кандай реалдуу камера кадрлары жок.

Демо объект чыныгы кардардан алынган маалыматтар эмес жана системанын функцияларын сыноо жана көрсөтүү үчүн гана арналган.

8. Схема менен иштөө

Оператор "Схема" бөлүмүн ачып, объектти жана деңгээлди тандайт, андан кийин:

• жалпы абалына баа берет;
• жалпысынан секторго жана жайгашкан жерге жылат;
• издөөнү колдонот;
• орун картасын ачат;
• көрүнүштөрдүн тарыхы;
• байланыштуу окуяларды карап чыгуу;
• зарыл болгон кошумча катмарларды гана камтыйт.

Жердин эксплуатациялык абалын өзгөртүү уруксат менен гана жүргүзүлөт. Топтук операция үчүн, тастыктоодон мурун жабыркаган жерлердин санын текшеришиңиз керек.

9. Окуяны жөнгө салуу

Сунушталган тартип:

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

Окуя катаны жашыруу үчүн жок кылынбайт: оператордун чечими тарыхта жана аудитте калышы керек.

10. Журнал жана аналитика

Сапар журналы жеткиликтүү параметрлердин негизинде чыпкаларды колдонот. Унаа идентификаторлоруна кирүү ага муктаж болгон ролдор менен гана чектелет.

Аналитикада метрикаларды чечмелөөдөн мурун тандалган объектти жана деңгээлди текшериңиз. Контекстти эске албай туруп, ар кандай маалымат аймактарынын маанилерин салыштыра албайсыз.

11. Жабдуулар

Техникалык адис контролдойт:

• абалын көрсөтүү үчүн, ал эми абалын көрсөтпөйт. online же offline;
• акыркы окуянын убактысы;
• жеткиликтүүлүгүн өзгөртүү тарыхы;
• объектке жана зонага байлоо;
• айдоочу параметрлери;
• коопсуз буйруктун натыйжасы.

Дарбазага же башка кыймылдаткычка буйрук жөнөтүүдөн мурун, сиз буйрук объекттин ченемдерине ылайык кабыл алынганына жана коркунуч жаратпагандыгына ынануу керек.

Эмуляторлор функционалдык тестирлөө үчүн реалдуу жабдыктарды туташтырбастан колдонулат.

12. Упайлар такталары жана шаблондор

Таблица бөлүмүндө администратор же ыйгарым укуктуу техникалык адис:

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

Шаблон жана максат серверде сакталат. Экран оператордун ачык сессиясынан көз каранды болбошу керек. Артыкчылыктуу шашылыш билдирүү кадимки маалымат мазмунуна караганда артыкчылыкка ээ.

Сменалык шаблондорду башкаруу жана оператордун жеке макеттерин көчүрүү - бул келечектеги өнүгүү; Сервер тараптагы табло үлгүлөрүнүн бекитилген топтому аларды чыгарууга чейин колдонулат.

13. Колдонуучулар жана укуктар

Администратор:

• жеке эсептерди түзөт;
• минималдуу талап кылынган ролдорду дайындайт;
• токтотулган же которулган кызматкерлердин эсептерин өчүрөт;
• ролдордун составын мезгил-мезгили менен текшерип турат;
• аудит журналын талдайт;
• туруктуу колдонуучулар менен кызмат сырларын бөлүшпөйт.

Серверге физикалык жетүү менен өзүнчө буйрукту колдонуу менен администратордун сырсөзүн баштапкы абалга келтирүү пландаштырылган функция болуп саналат. Чыгарылганга чейин кирүү мүмкүнчүлүгүн калыбына келтирүү резервдик көчүрмөсү жана аракеттердин журналы менен бекитилген тейлөө процедурасына ылайык гана жүргүзүлөт.

14. Сменаны башкаруу

Сменанын башталышында оператор текшерет:

• веб-интерфейстин жеткиликтүүлүгү;
• объектинин жана деңгээлинин тууралыгы;
• активдүү окуялардын саны;
• оффлайн түзмөктөрдүн болушу;
• маалымат экрандарынын актуалдуулугу;
• системасы эскертүүлөр жок.

Сменаны өткөрүп берүү учурунда бүтпөгөн окуялар, убактылуу иштен чыккан жерлер, бузулган түзүлүштөр жана колдонулган авариялык билдирүүлөр жазылат.

15. Камдык көчүрмө

Маалымат базасынын көчүрмөсүн түзүү:

tools/backup/backup.sh /path/to/backups

Медиа SHA-256 текшерүүсү менен өзүнчө S3 шайкеш сактагычка көчүрүлөт. Камдык сактоо чоо-жайы укуктары менен корголгон env файлы аркылуу өткөрүлүп берилет 0600буйрук сабынын аргументтери аркылуу эмес.

Маалымат базасын күн сайын жана жума сайын медиа көчүрүп туруу сунушталат. Убактылуу чөйрөгө калыбына келтирүү мезгил-мезгили менен жүргүзүлүп, контролдук эсептегичтер текшерилет.

16. Жаңыртуу

Жаңыртуудан мурун:

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

Жаңыртуу системанын администратору тарабынан белгилүү бир версия үчүн өзүнчө нускамаларга ылайык жүзөгө ашырылат. Тег менен буйрукту колдонуу менен тутумду жаңырта албайсыз latest сүрөттөрдү жана маалымат базасын схемасын аныктоо жок.

Учурдагы версияда интерфейстен автоматтык жаңыртуу жок.

17. Журналдар жана диагностика

Акыркы журналдар:

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

Орнотуу журналы:

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

Колдоо менен байланышканда, алар версияны, убакытты, аракеттердин ырааттуулугун, катаны, контейнерлердин абалын жана тиешелүү журналдарды сактап калышат. Сырлар жана жеке маалыматтар берилээрден мурун өчүрүлөт же маскаланат.

18. Типтүү каталар

19. Бузулган учурда аракеттер

19.1. NATS жеткиликтүү эмес

NATSти кайра иштетиңиз жана текшериңиз /healthz. Көлөмдүн Gateway чыгыш кутусун жок кылбаңыз: калыбына келтирилгенден кийин, Gateway сакталган окуяларды жөнөтүшү керек.

19.2. Камера жеткиликтүү эмес

Камеранын кубатын жана тармагын, жүрөктүн акыркы кагышын жана түзмөк таржымалын текшериңиз. Калыбына келтирилгенге чейин анын жерлери акыркы белгилүү абалында калышы мүмкүн.

19.3. Диск толду

өсүү булагын аныктоо. Көзөмөлдөө таржымалын өзүнчө процедураны колдонуу менен тазалоого болот, бирок PostgreSQL, S3 же Gateway кутусун резервдик көчүрмөсүз жана кесепеттерин баалоосуз жок кылуу мүмкүн эмес.

19.4. Маалыматтын бузулушу

Маалыматтарды өзгөртүү компоненттерин токтотуп, журналдарды жана учурдагы абалды сактап, андан кийин текшерилген көчүрмөдөн гана калыбына келтириңиз. Кайталануучу миграцияны сокур кылып иштетпеңиз.

20. Жарамдуулук мөөнөтү

Демейки маанилер:

Иш жүзүндөгү убакыт объект ээсинин саясаты жана тиешелүү талаптар менен аныкталат. Тергөөлөргө жана отчеттуулукка тийгизген таасири мөөнөтү кыскарганга чейин каралат.

21. Коопсуздук талаптары

• жеке эсептерди колдонуу;
• эң аз артыкчылык принцибин колдонуу;
• брандмауэр менен тармакка кирүүнү чектөө;
• env файлдарын жана камдык көчүрмөлөрүн жабык каталогдордо сактоо;
• PostgreSQL жана NATSти жарыялабаңыз;
• системанын убактысын синхрондоштуруу;
• аудит журналын такай текшерүү;
• өзүнчө купуялык кабыл алынбастан унааны коомдук издөөнү иштетпеңиз;
• Симптомду диагноз койбостон чечүү үчүн маалыматтарды жок кылбаңыз.

22. Операцияны аяктоо

Агрегатты иштен чыгаруунун алдында:

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