Files
XC_VM/tools/test-install/README.md
T
Divarion_D 175198a902 refactor(stream-check): merge checker and grapher into one stream_check.py
Consolidate the two stream-check tools into a single master script with
three subcommands:

- check <url>          verify one stream (or --live dashboard)
- playlist <path|url>  batch an .m3u list -> aggregate JSON (+ per-stream files)
- graph <inputs...>    render the JSON as SVG charts

Shared helpers (HTTP, slugify, m3u/JSON handling) are now defined once.
The old --playlist flag becomes the `playlist` subcommand and the bare-URL
form becomes `check <url>`; the streamtest harness is updated accordingly.

Also fix the per-stream SVG rendering black in viewers that do not support
8-digit #rrggbbaa hex: the bitrate area fill and not-PLAYING bands now use
6-digit hex plus a separate fill-opacity attribute.

Docs (English + tools READMEs + STREAMTEST) updated to the new invocation.
Removes stream_queue_check.py and stream_graph.py.
2026-09-06 11:11:10 +03:00

4.5 KiB

Test Install Container

Тестовый Docker-контейнер Ubuntu 24.04 для проверки установки XC_VM из dist/XC_VM.zip.

Требования

  • Docker + Docker Compose
  • Собранный dist/XC_VM.zip (через make main)

Структура

tools/test-install/
├── Dockerfile                   # образ Ubuntu 24.04 + systemd + встроенный install-скрипт
├── docker-compose.yml           # runtime-конфиг (volumes, ports, privileged, cgroup)
├── test_release.sh              # управляющий скрипт (install / clean / logs / sync / streamtest*)
├── streamtest_in_container.sh   # прогон стрим-теста внутри контейнера
├── STREAMTEST.md                # инструкция по e2e стрим-тесту (ручная настройка → бэкап → прогон)
└── README.md

Использование

# Собрать образ, запустить контейнер и выполнить установку (всё сразу)
./tools/test-install/test_release.sh

# Запустить на нестандартном host-порту (пример: HTTP 18080, HTTPS 18443)
XCVM_HTTP_PORT=18080 XCVM_HTTPS_PORT=18443 ./tools/test-install/test_release.sh

# Задать нестандартные внутренние порты панели (те, что пишет install в nginx)
XCVM_INSTALL_HTTP_PORT=8081 XCVM_INSTALL_HTTPS_PORT=4443 ./tools/test-install/test_release.sh

# Комбинированно: внешние и внутренние порты одновременно
XCVM_HTTP_PORT=18080 XCVM_HTTPS_PORT=18443 XCVM_INSTALL_HTTP_PORT=8081 XCVM_INSTALL_HTTPS_PORT=4443 ./tools/test-install/test_release.sh

# Удалить контейнер и образ
./tools/test-install/test_release.sh clean

# Посмотреть лог установки
./tools/test-install/test_release.sh logs

# Синхронизировать src/ в работающий контейнер
./tools/test-install/test_release.sh sync

# Войти в контейнер вручную
docker exec -it xcvm-test-install bash

Стрим-тест (e2e)

Сквозная проверка стриминга панели: генератор → рестрим панели → stream_check.py (JSON-лог по каждому каналу). Панель настраивается один раз вручную, конфигурация снимается в дамп БД и восстанавливается для повторяемых прогонов — без прямых SQL-запросов. Полная инструкция: STREAMTEST.md.

./tools/test-install/test_release.sh streamtest-gen        # генератор для ручной настройки
./tools/test-install/test_release.sh streamtest-backup     # снять дамп настроенной БД
./tools/test-install/test_release.sh streamtest            # восстановить дамп и прогнать checker

Что проверяется

Встроенный в Dockerfile install-скрипт:

  1. Распаковывает XC_VM.zip
  2. Запускает python3 install с автоматическими ответами на интерактивные вопросы
  3. Проверяет наличие ключевых файлов после установки:
    • /home/xc_vm/console.php, vendor/autoload.php, bootstrap.php
    • /home/xc_vm/config/config.ini
    • /home/xc_vm/bin/nginx/sbin/nginx
    • /home/xc_vm/bin/php/bin/php
    • /home/xc_vm/bin/redis/redis-server

Порты

  • XCVM_HTTP_PORT (по умолчанию 8880) → container XCVM_INSTALL_HTTP_PORT (или 80)
  • XCVM_HTTPS_PORT (по умолчанию 8443) → container XCVM_INSTALL_HTTPS_PORT (или 443)

Внутренние порты, которые настраивает install в контейнере:

  • XCVM_INSTALL_HTTP_PORT (по умолчанию пусто → 80)
  • XCVM_INSTALL_HTTPS_PORT (по умолчанию пусто → 443)

Важно: маппинг target-порта теперь синхронизирован автоматически с XCVM_INSTALL_HTTP_PORT/XCVM_INSTALL_HTTPS_PORT.

Примечания

  • Контейнер запускается с --privileged и systemd (PID 1) — необходимо для systemctl
  • MariaDB устанавливается и настраивается внутри контейнера