Перейти к содержанию

Установка и настройка модуля mint_webinar

Описание

Модуль mint_webinar позволяет проводить вебинары.

Для трансляции вебинаров используется модуль mint_rec, он должен быть установлен и настроен до начала установки mint_webinar.

Требования к инфраструктуре

Операционная система

Операционная система на базе Linux.

Рекомендуемые дистрибутивы:

  • Astra Linux — версия 1.7 и выше

  • RedOS — версия 7.3 и выше

  • ALT Linux — версия 9 и выше

  • Ubuntu — версия 20.04 и выше

  • CentOS — версия 7 и выше

  • Debian — версия 11 и выше

  • Fedora — версия 36 и выше

  • RHEL — версия 7 и выше

Примечание

На всех серверах, где установлены модули MINT, рекомендуется использовать один и тот же дистрибутив.

Необходимое программное обеспечение

  • Docker Engine версии 24 и выше

  • Пакет python3 версии 3.10 и выше

Системные требования

Требования к серверу:

  • Процессор — 4 vCPU

  • Оперативная память — 4 ГБ

  • Дисковое пространство — 80 ГБ

IP-адресация

При установке на отдельный сервер:

  • 1 внутренний (частный) IP-адрес — для взаимодействия с mint_rec и mint_mgmt

  • 1 внешний (публичный) IP-адрес — для подключения пользователей или NAT

Сетевое взаимодействие

  1. С сервера mint_rec доступно соединение к mint_webinar по указанному порту:

    • TCP/1935

  2. На внешнем (публичном) IP-адресе mint_webinar должны быть разрешены входящие подключения по указанному порту:

    • TCP/443

Доменные имена и сертификаты

Для работы mint_webinar необходимо:

  • Доменное имя для mint_webinar

  • SSL-сертификат на данный домен

Примечание

Если у вас нет сертификата, вы можете воспользоваться встроенным механизмом автоматического получения сертификата Let's Encrypt. Процесс настройки описан далее.

Установка Docker Engine

Установите Docker Engine с помощью официального скрипта установки

sudo curl -fsSL https://get.docker.com | sh

Либо по инструкции на официальном сайте, предназначенной для вашего дистрибутива Linux. Инструкция по установке Docker Engine

Установка mint_webinar

  1. Загрузите архив с дистрибутивом. Скачать

  2. Распакуйте загруженный архив в произвольную директорию, данная директория необходима только на время установки и не будет использоваться для работы ПО.

  3. Запустите скрипт установки setup_webinar.py из директории mint_webinar и следуйте подсказкам установщика.

Примечание

Модуль mint_webinar будет установлен в директорию /opt/mint/webinar.

Дальнейшую настройку, а также запуск и остановку контейнеров необходимо выполнять в данной директории.

Настройка mint_webinar

Перейдите в директорию /opt/mint/webinar и заполните в файле .env следующие параметры:

  • DOMAIN — доменное имя для mint_webinar
  • INTERNAL_IP — внутренний (частный) IP-адрес сервера mint_webinar

Обратите внимание

Доменное имя mint_webinar является сервисным и используется для трансляции видео. Переходить по нему не требуется.

Настройка сертификата

Выберите один из вариантов и выполните только те действия, которые указаны в выбранном варианте.

Собственный сертификат

  1. В .env файле mint_webinar укажите:

    • ENABLE_LETSENCRYPT — false

  2. Разместите сертификат и ключ в директории /opt/mint/webinar/configs/certs с именами:

    • fullchain.pem — сертификат

    • key.pem — ключ

Сертификат Let's Encrypt

В .env файле mint_webinar укажите:

  • ENABLE_LETSENCRYPT — true

  • LETSENCRYPT_EMAIL — действующий адрес электронной почты

Настройка передачи записей

  1. Создайте SSH-ключ пользователя root:

    sudo ssh-keygen -t rsa -b 4096 -N "" -f /opt/mint/webinar/configs/ssh_keys/id_rsa

  2. Примечание

    Данный пункт выполняется на сервере mint_mgmt.

    Добавьте все содержимое из файла /opt/mint/webinar/configs/ssh_keys/id_rsa.pub сервера mint_webinar в /home/"username"/.ssh/authorized_keys на сервере mint_mgmt.

    Если файл authorized_keys отсутствует, его необходимо создать.

  3. В .env файле mint_webinar заполните следующие параметры:

    • MGMT_USER — имя пользователя сервера mint_mgmt, для которого был добавлен SSH-ключ сервера mint_webinar

    • MGS_LOCAL_IP — внутренний (частный) IP-адрес сервера mint_mgmt

    • MGMT_SSH_PORT — порт SSH для подключения к mint_mgmt

Настройка сервера mint_mgmt

Примечание

Данный пункт выполняется на сервере mint_mgmt.

  1. Откройте файл .env в директории /opt/mint/mgmt и заполните следующие параметры:

    • WEBINARS_ENABLED — true

    • WEBINAR_DOMAIN — доменное имя сервера mint_webinar

    • WEBINAR_PUSH_URL — адрес публикации потока в формате rtmp://<доменное имя mint_webinar>:1935/app

    Например

    WEBINAR_PUSH_URL=rtmp://webinar.mintconf.ru:1935/app

  2. Перезапустите контейнеры, находясь в директории /opt/mint/mgmt, выполнив команды:

    docker compose stop

    docker compose up -d

Настройка сервера mint_rec

Примечание

Данный пункт выполняется на сервере mint_rec.

  1. Откройте файл .env в директории /opt/mint/rec и заполните следующие параметры:

    • WEBINAR_DOMAIN — доменное имя сервера mint_webinar

    • WEBINAR_LOCAL_IP — внутренний (частный) IP-адрес сервера mint_webinar

  2. Перезапустите контейнеры, находясь в директории /opt/mint/rec, выполнив команды:

    docker compose stop

    docker compose up -d

Запуск mint_webinar

В директории /opt/mint/webinar запустите контейнеры командой

docker compose up -d

Проверьте, что все контейнеры успешно запустились, командой:

docker ps -a

Все контейнеры должны иметь статус “Up”.