Все переводы

Материал из SmartPlayer

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

Сообщение

Найдено 2 перевода.

СообщениеТекущий текст
 ист. английский (en)== '''Docker and Docker Compose Installation''' ==  
Depending on the operating system, the user independently selects the appropriate Docker and Docker Compose version required for installation on the server OS:

{| class="wikitable"
|+ Docker and Docker Compose Versions
|-
! Link to docker / docker-compose archive !! Description
|-
|[https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker-and-docker-compose_ubuntu_server_24_04.tar.gz Link] || Archive for offline Docker installation for Ubuntu Server 24.04 LTS
|-
|[https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker-and-docker-compose_ubuntu_server_22_04.tar.gz Link] || Archive for offline Docker installation for Ubuntu Server 22.04 LTS
|}

== '''Installation Algorithm''' ==  
{{Note|Due to fonts, some commands may appear to use curly quotes. This is not the case — single quotes are used.|warn}}  
{{Note|Replace the "*" symbol with the actual file version in the commands below.|warn}}

'''Be sure to request a new user account from the SmartPlayer technical support team.'''<br>  
Create a SmartPlayer user without root privileges. After installing the server application, authorization under this user must be disabled.

To continue installation, connect to the server and upload all archives to the SmartPlayer user's home directory. You may use the "sftp" utility or any other method — the key requirement is that the archives are uploaded to the server.<br>

It is recommended to use our offline archive for installation. However, in some cases installation from the customer’s repository is required. Both options are described below:

* Extract the Docker archive and navigate to the extracted directory:<br>  
<code>tar -zxvf docker-and-docker-compose*.tar.gz && cd docker-and-docker-compose*</code>

* Install Docker and required components:<br>  
<code>sudo ./install-docker-and-docker-compose-offline.sh</code>

* Update package lists:<br>  
<code>apt update</code>

* Install docker and docker compose packages:<br>  
<code>apt install docker.io docker-compose-v2</code>

* '''Optional:''' to run docker without sudo, add the user to the docker group:  
<code>sudo usermod -aG docker $USER</code>

* Add the SmartPlayer user to the docker group:  
<code>sudo usermod -aG docker smartplayer</code><br>  

After completing the above steps, disconnect from the server and reconnect.

* Verify Docker and Docker Compose installation:  
<code>docker --version</code>  

The output depends on the operating system.  

<code>docker-compose --version</code><br>  

The response will depend entirely on the operating system:  
[[File:Ответ_операционки.png|thumb|center| Example of output |800px]]

{{Note|For docker-compose ver.2 (included in Ubuntu archives starting from Ubuntu 24.04), it is recommended to enable compatibility mode (runs via "docker-compose", containers use "_" as separator):  
*<code>sudo echo 'docker compose --compatibility "$@"' > /bin/docker-compose</code>  
*<code>sudo chmod +x /bin/docker-compose</code>|warn}}

* Enable Docker auto-start:  
<code>sudo systemctl enable docker</code>

== '''Server Application Installation''' ==  

* Extract the archive into the directory where the platform will be installed. Replace "*" with the actual file version:  
<code>unzip sp_docker_v_*.zip -d smartplayer</code>

* Import Docker images (wait until images finish loading):  
<code>docker image load -i /home/smartplayer/smartplayer/tools/installer/docker_images_*.tar.gz</code>

* Verify all images were loaded:  
<code>docker image ls</code>

The result should match the screenshot below:  
[[File:Вывод_докера.png|thumb|center| Example output |800px]]

*If an error appears on Astra Linux during image loading such as:*  
<code>directory '/var/lib/docker/overlay2/... contains vulnerabilities!... Astra Linux - vulnerability in openssl ...</code>

You must execute the following:

<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>

After that, reload the images.<br>

* '''Optional:''' if images were successfully loaded, remove the archive:  
<code>rm docker_images_*.tar.gz</code>

* Change ownership for the server application directory:  
<code>sudo chown -R smartplayer:smartplayer /home/smartplayer/smartplayer</code>

* Switch to SmartPlayer user and perform further steps under this account:  
<code>sudo su smartplayer</code>

* Navigate to the server application directory:  
<code>cd /home/smartplayer/smartplayer</code>

* Configure env file:  
<code>mv .env.example .env</code>  
<code>nano .env</code>

* The user must fill in the following fields:  
{{Note|
# MYSQL_ROOT_PASSWORD, MYSQL_PASSWORD — passwords for MySQL connection (generate them)  
# CMS_URL — Personal account URL. Example: if the server is available at "http://192.168.56.101/cms", specify this address (without trailing slash).  
# APP_URL — Server application URL. Example: if the server is available at "http://192.168.56.101", specify this address (without trailing slash).  
Save configuration and exit. (ctrl+S, ctrl+X)  
[[File:Конфиг_с_параметрами.png|thumb|center| Example configuration with highlighted parameters |800px]] |warn}}

* If using https, add the certificate chain and private key named ssl.crt and ssl_private.key into:  
/home/smartplayer/smartplayer/nginx/ssl/

* Start applications and wait 2 minutes:  
<code>docker-compose up -d</code>

* Create database tables:  
<code>docker exec -it smartplayer_backend_1 sh -c './cli.js db init'</code>

* Upload widgets:  
<code>docker exec -it smartplayer_backend_1 sh -c './cli.js widgets upload'</code>

* Create user:  
<code>docker exec -it smartplayer_backend_1 sh -c './cli.js company create-with-user'</code>

{{Note|By default, the SmartPlayer technical support team should create the first user with login — root@smartplayer.org.<br>  
If an error occurs during user creation, repeat the previous step and recreate DB tables.|warn}}

* Check server application status:  
<code>docker exec -it smartplayer_backend_1 sh -c 'pm2 list'</code>

Correct output example:  
[[File:Корректный_вывод.png|thumb|center| Example of correct output |800px]]

* Enable automatic MySQL DB backups (run under smartplayer user):  
<code>./mysql_backup/init_auto_backups.sh</code>

* Verify MySQL backups:  
<code>./mysql_backup/mysql_backup.sh</code>

* The server application will then be available in the browser at the address specified in the CMS_URL variable.
 ист. русский (ru)== '''Установка 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
Источник — https://wiki.smartplayer.org/index.php?title=Служебная:Переводы