Все переводы

Материал из SmartPlayer

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

Сообщение

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

СообщениеТекущий текст
 ист. английский (en)== '''Installing Docker and Docker-compose''' ==  
Depending on the operating system, the user selects the appropriate version of Docker and Docker-compose for installation on the server OS:  
{| class="wikitable"  
|+ Versions of Docker and Docker-compose  
|-  
! Link to the archive with docker / docker-compose !! Description  
|-  
|[https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker-and-docker-compose_ubuntu_server_24_04.tar.gz Link] || Archive for offline installation of Docker 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 installation of Docker for Ubuntu Server 22.04 LTS  
|-  
|[https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker-and-docker-compose_ubuntu_server_18_04.tar.gz Link] || Archive for offline installation of Docker for Ubuntu Server 18.04 LTS  
|-  
|[https://distributions.hb.bizmrg.com/PLATFORM/GENERAL/docker-and-docker-compose_ubuntu_server_16_04.tar.gz Link] || Archive for offline installation of Docker for Ubuntu Server 16.04 LTS  
|}  
== '''Installation Algorithm''' ==  
{{Note|Due to font rendering, some commands may appear to use slanted quotes. However, only single quotes are used.|warn}}  
{{Note|Replace the "*" symbol with the actual version of the file in the specified commands.|warn}}  
'''Be sure to request a new user from the SmartPlayer technical support team.'''  
To begin installation, connect to the server and upload all archives to the home directory of the SmartPlayer user. You can use the "sftp" utility or any other method to upload the archives to the server.  
* 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 the necessary components:<br>  
<code>sudo ./install-docker-and-docker-compose-offline.sh</code>  
* '''Optional:''' To use 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, the user should disconnect and reconnect to the server.  
* Verify the functionality of Docker and Docker Compose:  
<code>docker --version</code>  
* The response depends on the operating system where Docker is installed.  
<code>docker-compose --version</code><br>  
The response will vary based on the operating system:  
[[File:Ответ_операционки.png|thumb|center| Example response display |800px]]  
{{Note|For docker-compose ver.2 (included in archives for Ubuntu starting from version 24.04), it is recommended to enable compatibility mode (works with the "docker-compose" command, and containers use "_" as a separator):  
* <code>echo 'docker compose --compatibility "$@"' > /bin/docker-compose</code>  
* <code>chmod +x /bin/docker-compose</code> |warn}}  
* Enable Docker to start on boot:  
<code>sudo systemctl enable docker</code>  
* Extract the archive to the specified directory where the platform will be installed. Replace "*" with the actual file version:  
<code>unzip sp_docker_v_*.zip -d smartplayer</code>  
* Extract the archive to the specified directory. Path: "~/application_directory/backend/app/".  
<code>unzip node_module_bv_*.zip –d ~/smartplayer/backend/app/</code>  
* Enable the server configuration with the command:  
<code>mv ~/smartplayer/backend/app/pm2.app.config.example.js ~/smartplayer/backend/app/pm2.app.config.js</code>  
* Import Docker images:  
<code>docker image load -i /home/smartplayer/smartplayer/tools/installer/docker_images_*.tar.gz</code>  
* Verify that all images have been loaded:  
<code>docker image ls</code>  
The expected result should look like the screenshot below:  
[[File:Вывод_докера.png|thumb|center| Example display |800px]]  
* '''Optional:''' If everything has loaded successfully, the image archive can be deleted:  
<code>rm docker_images_v3.3.1.tar.gz</code>  
* Fill in the environment configuration:  
<code>mv .env.example .env</code>  
<code>nano .env</code>  
* The user should fill in the following fields:  
{{Note|  
# MYSQL_ROOT_PASSWORD, MYSQL_PASSWORD - passwords for MySQL connection (generate a strong password).  
# CMS_URL - URL of the personal account. For example, if the server is accessible at "http://192.168.56.101/cms", specify this address (without a trailing slash).  
# APP_URL - URL of the server application. For example, if the server is accessible at "http://192.168.56.101", specify this address (without a trailing slash).  
# MYSQL_BACKUP_DOCKER_CONTAINER - specify the MySQL container, e.g., smartplayer_mysql_1  
# MYSQL_BACKUP_STORAGE - specify the MySQL backup type, e.g., local  
# MYSQL_BACKUP_LOCAL_DIR - specify the absolute path to the directory, e.g.:  
  "/home/smartplayer/smartplayer/data/mysql-dumps/"  
Save the configuration and exit. (ctrl+S, ctrl+X)  
[[File:Конфиг_с_параметрами.png|thumb|center| Example configuration display with highlighted parameters |800px]] |warn}}  
* Change the server address in the personal account configuration:  
<code>nano cms/cms/config.js</code><br>  
Modify the "ip_address" parameter:  
[[File:Ип_адрес.png|thumb|center| Example display of the modified IP address |800px]]  
* Enable automatic MySQL database backups (run this command as the SmartPlayer user):  
<code>./mysql_backup/init_auto_backups.sh</code><br>  
To manually check MySQL backups, use the command:<br>  
<code>sudo -u smartplayer /home/smartplayer/smartplayer/mysql_backup/mysql_backup.sh</code>  
* Configure "nginx". Copy the appropriate configuration file depending on the server setup. In this case, the personal account and the server share the same IP address:  
<code>cp nginx/conf_examples/one_domain/http/smartplayer.conf nginx/conf/</code>  
<code>nano nginx/conf/smartplayer.conf</code>  
[[File:Имя_сервера.png|thumb|center| Example display of the configuration where the personal account and server share the same IP address |800px]]  
Save the configuration and exit. (ctrl+S, ctrl+X)  
* Start the 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 a 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 the login - root@smartplayer.org.<br>  
If an error occurs while creating the user, repeat the previous step to create database tables.|warn}}  
* Check the server application status using the command:  
<code>docker exec -it smartplayer_backend_1 sh -c 'pm2 list'</code>  
A correct output should look like the example below:  
[[File:Корректный_вывод.png|thumb|center| Example display of the correct output |800px]]
 ист. русский (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.'''
Для начала установки необходимо подключиться к серверу и загрузить все архивы на сервер в домашнюю директорию пользователя SmartPlayer. Для загрузки можно использовать утилиту "sftp" или другую, главное загрузить архивы на сервер. Далее6
* Распаковать архив с 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>
* '''Опционально:''' чтобы вызывать 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>echo 'docker compose --compatibility "$@"' > /bin/docker-compose</code>
*<code>chmod +x /bin/docker-compose</code>|warn}}
* Включить автозапуск Docker:
<code>sudo systemctl enable docker</code>
* Распаковать архив в указанную директорию, в которую будет устанавливаться платформа. Символ "*" заменить на актуальную версию файла.
<code>unzip sp_docker_v_*.zip -d smartplayer</code>
* Включить конфигурацию сервера с помощью команды:
<code>mv ~/smartplayer/backend/app/pm2.app.config.example.js ~/smartplayer/backend/app/pm2.app.config.js</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]]
* '''Опционально:''' если всё загрузилось успешно, то можно удалить архив с образами:
<code>rm docker_images_v3.3.1.tar.gz</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", то указать этот адрес (без слеша на конце).
# MYSQL_BACKUP_DOCKER_CONTAINER - указать контейнер mysql, например: smartplayer_mysql_1
# MYSQL_BACKUP_STORAGE - указать тип бекапа mysql, например: local
# MYSQL_BACKUP_LOCAL_DIR - указать абсолютный путь к директории, например:<br>
  "/home/smartplayer/smartplayer/data/mysql-dumps/"
Сохранить конфигурацию и выйти. (ctrl+S, ctrl+X)
[[File:Конфиг_с_параметрами.png|thumb|center| Пример отображения конфигурации с выделенными параметрами|800px]] |warn}}
* Далее меняем адрес сервера в конфигурации личного кабинета:
<code>nano cms/cms/config.js</code><br>
Нужно изменить значение параметра "ip_address":
[[File:Ип_адрес.png|thumb|center| Пример отображения изменённого значения Ip-адреса|800px]]
* Включить автоматическое создание бэкапов базы данных MySQL (данную команду необходимо выполнять из под пользователя SmartPlayer):
<code>./mysql_backup/init_auto_backups.sh</code><br>
Для проверки бэкапов БД MySQL используем команду:<br>
<code>sudo -u smartplayer /home/smartplayer/smartplayer/mysql_backup/mysql_backup.sh</code>
* Настроить конфигурацию "nginx". Скопировать нужный файл конфигурации в зависимости от настройки сервера. В данном случае личный кабинет и сервер на одном ip адресе, используется протокол http:
<code>cp nginx/conf_examples/one_domain/http/smartplayer.conf nginx/conf/</code><br>
<code>nano nginx/conf/smartplayer.conf</code>
{{Note|"one_domain" - подразумевает что сервера находятся на одном адресе. Также необходимо предусмотреть тип подключения: http/https|warn}}
[[File:Имя_сервера.png|thumb|center| Пример отображения настройки в которой личный кабинет и сервер на одном ip адресе|800px]]
Сохранить конфигурацию и выйти. (ctrl+S, ctrl+X)
* Запустить приложения и подождать 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]]