Просмотр кода страницы Оффлайн установка платформы SmartPlayer на операционный системы Ubuntu / Astra

<languages/>
<translate>
<!--T:1-->
== '''Описание ситуации''' ==
На странице будет описана информация о возможности самостоятельной off-line установки платформы SmartPlayer на операционные системы Ubuntu и Astra.
== '''Поддерживаемые версии''' ==
{| class="wikitable"
|+ Таблица поддерживаемых версий
|-
! Операционная система !! Дистрибутив операционной системы  !! Рекомендуется для установки
|-
| Ubuntu Server 24.04 LTS || [https://image_os.hb.bizmrg.com/ubuntuServer/ubuntu-24.04.1-live-server-amd64.iso Ссылка] || Да
|-
| Ubuntu Server 22.04 LTS || [https://image_os.hb.bizmrg.com/ubuntuServer/ubuntu-22.04.2-live-server-amd64.iso Ссылка] || Да
|-
| AstraLinux Orel || [https://image_os.hb.bizmrg.com/astraLinux/astra-linux-orel.iso Ссылка] || Да, для государственных Органов.<br>
* Distributor ID:	AstraLinuxCE
* Description:	 Astra Linux CE 2.12.43 (Orel)
* Release:	2.12.43
* Codename:	orel
|}

<!--T:3-->
== '''Подробнее''' ==
Представитель SmartPlayer передает следующий состав платформы. Версии архивов могут отличаться, зависит от конкретной версии, которая разворачивается на примере. Обычно представитель SmartPlayer присылает актуальную версию для текущего момента:
{{Note| Если используется серверное приложение использующее 20 NodeJS, то необходимо загрузить [https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker_images_v3.4.1.tar.gz docker_images_v3.4.1.tar.gz]|warn}}
{{Note|Также их можно найти в архиве с серверным приложением, по пути: <code>smartplayer/tools/installer/</code>|warn}}
* '''sp_docker_v_${current_version_docker}_bv_${current_version_backend}_fv_${current_version_frontend}.zip''' - архив с серверным приложением платформы SmartPlayer, конфигурационные файл для Docker, собранный по умолчанию личный кабинет платформы
* [https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/unzip_6.0-21ubuntu1_amd64.deb unzip_6.0-21ubuntu1_amd64.deb] - пакет для разархивирования zip-архивов на сервере. По умолчанию в Ubuntu сервер идет архиватор ".tar" который не умеет разархивировать "zip"-файлы. Можно в процессе перепаковать файлы и потом загрузить их на сервер, тогда не потребуется установка пакета на сервере.<br>
</translate>
<translate>
<!--T:2-->
== '''Установка Docker и Docker-compose''' ==
В зависимости от операционной системы пользователь сам выбирает версию Docker и Docker-compose необходимую для установки на серверную операционную систему:
{| class="wikitable"
|+ Версии Docker и Docker-compose|-
! Ссылка на архив с docker / docker-compose !! Описание
|-
|[https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker-and-docker-compose_ubuntu_server_24_04.tar.gz Ссылка] || Архив для оффлайн установки Docker для Ubuntu Server 24.04 LTS
|-
|[https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker-and-docker-compose_ubuntu_server_22_04.tar.gz Ссылка] || Архив для оффлайн установки Docker для Ubuntu Server 22.04 LTS
|}
== '''Алгоритм установки''' ==
{{Note|Из-за шрифтов в некоторых командах может казаться, что используются косые кавычки. Это не так, там используются одинарные кавычки.|warn}}
{{Note|Заменить символ - "*" на актуальную версию файла в описанных командах|warn}}
'''Обязательно запросить нового пользователя у команды технической поддержки SmartPLayer.'''<br>
Создать пользователя SmartPlayer, без root-прав, после установки серверного приложения, необходимо запретить авторизацию под данным пользователем.
Для продолжения установки необходимо подключиться к серверу и загрузить все архивы на сервер в домашнюю директорию пользователя SmartPlayer. Для загрузки можно использовать утилиту "sftp" или другую, главное загрузить архивы на сервер.<br>
Рекомендуется использовать для установки наш offline-архив. Однако бывают случаи, когда требуется установка из репозитория заказчика. Далее описаны оба варианта:
* Распаковать архив с Docker, и перейти в распакованную директорию:<br>
<code>tar -zxvf docker-and-docker-compose*.tar.gz && cd docker-and-docker-compose*</code>
* Установить Docker и необходимых компонент:<br>
<code>sudo ./install-docker-and-docker-compose-offline.sh</code>
* Обновить списки пакетов:<br>
<code>apt update</code>
* Установить пакеты docker и docker compose:<br>
<code>apt install docker.io docker-compose-v2</code>
* '''Опционально:''' чтобы вызывать docker без sudo, добавить пользователя в группу docker:
<code>sudo usermod -aG docker $USER</code>
* Добавляем пользователя SmartPlayer в группу docker:
<code>sudo usermod -aG docker smartplayer</code><br>
Проделав вышеописанные действия пользователю необходимо отключиться от сервера и подключиться снова.
* Проверить работоспособность Docker и Docker Compose :
<code>docker --version</code>
* Ответ зависит от операционной системы куда устанавливается docker
<code>docker-compose --version</code><br>
Ответ будет зависеть полностью от операционной системы:
[[File:Ответ_операционки.png|thumb|center| Пример отображения ответа |800px]]
{{Note|Для docker-compose ver.2 (поставляется в архивах для ubuntu начиная с версии Ubuntu 24.04) рекомендуется включить режим совместимости (работает по команде "docker-compose", контейнеры используют разделитель в виде “_“):
*<code>sudo echo 'docker compose --compatibility "$@"' > /bin/docker-compose</code>
*<code>sudo chmod +x /bin/docker-compose</code>|warn}}
* Включить автозапуск Docker:
<code>sudo systemctl enable docker</code>
== '''Установка серверного приложения''' ==
* Распаковать архив в указанную директорию, в которую будет устанавливаться платформа. Символ "*" заменить на актуальную версию файла.
<code>unzip sp_docker_v_*.zip -d smartplayer</code>
* Импортировать образы Docker(потребуется подождать пока не перезагрузятся образы):
<code>docker image load -i /home/smartplayer/smartplayer/tools/installer/docker_images_*.tar.gz</code>
* Проверить, что все образы загрузились:
<code>docker image ls</code>
Результат, описанный выше действий должен быть как на скриншоте ниже:
[[File:Вывод_докера.png|thumb|center| Пример отображения|800px]]
*Если при загрузке образов на Astra Linux появляется ошибка вида:
<code>directory '/var/lib/docker/overlay2/09b534e0304c27ac3a735c11a0413b9508405c6807b1b910339e27a251a23cc0/merged' contains vulnerabilities! [{oval:astra:def:4531229522001128947937725208131 true  Astra Linux - уязвимость в openssl } {oval:astra:def:4373393375917990519923223647811 true  Astra Linux - уязвимость в openssl } {oval:astra:def:4214940672944626263348052579907 true  Astra Linux - уязвимость в openssl } {oval:astra:def:4056789016112106406191571490371 true  Astra Linux - уязвимость в openssl } {oval:astra:def:3898339921026663004431305758275 true  Astra Linux - уязвимость в openssl } {oval:astra:def:1099622894188402609980812330096195 true  Astra Linux - уязвимость в openssl }]. Image: 09b534e0304c27ac3a735c11a0413b9508405c6807b1b910339e27a251a23cc0</code>
Необходимо выполнить следующие действия:
<code>sudo mkdir /etc/docker
sudo touch /etc/docker/daemon.json
sudo cat << EOF > /etc/docker/daemon.json
{ "astra-sec-level" : 6 }
EOF
sudo systemctl restart docker</code><br>
После этих действий повторно загрузить образы.<br>
* '''Опционально:''' если всё загрузилось успешно, то можно удалить архив с образами:
<code> rm docker_images_*.tar.gz</code>
* Переназначить права для директории серверного приложения:
<code>sudo chown -R smartplayer:smartplayer /home/smartplayer/smartplayer</code>
* Зайти под пользователем SmartPlayer и дальнейшие действия выполнять этой учетной записью:
<code>sudo su smartplayer</code>
* Перейти в каталог серверного приложения:
<code>cd /home/smartplayer/smartplayer</code>
* Заполнить конфигурацию env:
<code>mv .env.example .env</code>
<code>nano .env</code>
* Пользователю необходимо заполнить следующий поля:
{{Note|
# MYSQL_ROOT_PASSWORD, MYSQL_PASSWORD - пароли для подключения к MySQL (сгенерировать)
# CMS_URL - URL личного кабинета. Например, если сервер будет доступен по адресу: "http://192.168.56.101/cms", то указать этот адрес (без слеша на конце).
# APP_URL - URL серверного приложения. Например, если сервер будет доступен по адресу: "http://192.168.56.101", то указать этот адрес (без слеша на конце).
Сохранить конфигурацию и выйти. (ctrl+S, ctrl+X)
[[File:Конфиг_с_параметрами.png|thumb|center| Пример отображения конфигурации с выделенными параметрами|800px]] |warn}}
* При использовании https добавить цепочку сертификатов и приватный ключ с именами ssl.crt и ssl_private.key в директорию /home/smartplayer/smartplayer/nginx/ssl/
* Запустить приложения и подождать 2 минуты:
<code>docker-compose up -d</code>
* Создать таблицы базы данных:
<code>docker exec -it smartplayer_backend_1 sh -c './cli.js db init'</code>
* Загрузить виджеты
<code>docker exec -it smartplayer_backend_1 sh -c './cli.js widgets upload'</code>
* Создать пользователя:
<code>docker exec -it smartplayer_backend_1 sh -c './cli.js company create-with-user'</code>
{{Note|Cтандартно, командой технической поддержки SmartPlayer? должен быть создан первый пользователь с логином - root@smartplayer.org.<br>
Если при создании пользователя выходит ошибка, необходимо повторить предыдущий шаг и создать таблицы БД.|warn}}
* Проверка работы серверного приложения, командой:
<code>docker exec -it smartplayer_backend_1 sh -c 'pm2 list'</code>
Корректный вывод будет показан на примере ниже:
[[File:Корректный_вывод.png|thumb|center| Пример отображения корректного вывода|800px]]
* Включить автоматическое создание бэкапов БД MySQL(данную команду необходимо выполнять из под пользователя smartplayer):
<code> ./mysql_backup/init_auto_backups.sh </code>
* Для проверки бэкапов My SQL используем команду:
<code>./mysql_backup/mysql_backup.sh</code>
* В дальнейшем серверное приложение будет доступно в браузере по адресу, указанному в переменной CMS_URL 
</translate>