Инструкция по обновлению сервера SmartPlayer в Docker сборке - История изменений

N.Bloshkin в 06:27, 2 февраля 2026

2026-02-02T06:27:00Z

N.Bloshkin в 12:08, 1 февраля 2026

2026-02-01T12:08:04Z

Внесённые изменения

S.Kargin в 08:45, 21 мая 2025

2025-05-21T08:45:37Z

← Предыдущая версия		Версия от 11:45, 21 мая 2025
Строка 112:		Строка 112:
	== '''"Откат" серверного приложения на прежнюю версию''' ==		== '''"Откат" серверного приложения на прежнюю версию''' ==
	* Убедиться, что "pm2" процессы остановлены:		* Убедиться, что "pm2" процессы остановлены:
	<code>docker exec -it ~~smartplyaer_backend_1~~ bash -c "pm2 list"</code>		<code>docker exec -it smartplayer_backend_1 bash -c "pm2 list"</code>
	* Если процессы не остановлены, то остановить:		* Если процессы не остановлены, то остановить:
	<code>docker exec -it ~~smartplyaer_backend_1~~ bash -c "pm2 stop all"</code>		<code>docker exec -it smartplayer_backend_1 bash -c "pm2 stop all"</code>
	* Если осуществлялся запуск миграций, то откатить миграции, восстановив базу данных из дампа:		* Если осуществлялся запуск миграций, то откатить миграции, восстановив базу данных из дампа:
	<code>source .env</code><br>		<code>source .env</code><br>
Строка 122:		Строка 122:
	* Проверить конфиги		* Проверить конфиги
	* Запустить "pm2":		* Запустить "pm2":
	<code>docker exec -it ~~smartplyaer_backend_1~~ bash -c "pm2 start pm2.app.config.js"</code>		<code>docker exec -it smartplayer_backend_1 bash -c "pm2 start pm2.app.config.js"</code>
	* Запустить Nginx:		* Запустить Nginx:
	<code>docker-compose start web</code>		<code>docker-compose start web</code>

N.Bloshkin в 13:36, 13 февраля 2025

2025-02-13T13:36:39Z

← Предыдущая версия		Версия от 16:36, 13 февраля 2025
Строка 57:		Строка 57:
	=== '''Итог''' ===		=== '''Итог''' ===
	После этого действия файл бэкапа должен появится у пользователя на ПК.		После этого действия файл бэкапа должен появится у пользователя на ПК.
	~~=== '''Тестирование в Jenkins''' ===~~
	Сначала полученный дамп загружается в облачное хранилище. После загрузки, переходим в “Jenkins“ , чтобы протестировать миграцию.
	~~[[File:Тестирование_миграции.png\|thumb\|center\| Пример подготовки тестирования миграции\|800px]]~~
	Необходимо запустить тестирование поставив галочку в разделе “TEST MIGRATIONS“, а также прописать название бэкапа в строке “DATABASE_BACKUP_NAME_IN_S3“.
	{{Note\|Для работы с бэкапами по дефолту используется “порт: 22”. Но есть сервера у которых значение порта может быть другим.<br>
	~~При подключении через нестандартный порт используются следующий команды:~~
	~~# <code>ssh -p 1234 smartplayer@ip_address_hostname</code> - команда для подключения через SSH~~
	# <code>scp -P 1234 smartplayer@ip_address_hostname:<путь до файла> <путь где нужно сохранить файл></code> - команда для получения файлов через SCP\|warn}}
	=== '''Обновление серверного приложения на машине заказчика''' ===		=== '''Обновление серверного приложения на машине заказчика''' ===
	{{Note\|Команды, указанные в данной инструкции выполняются из папки, которую обычно назsвают "smartplayer". Она содержит всю docker-сборку, в том числе и файл ".env".\|warn}}		{{Note\|Команды, указанные в данной инструкции выполняются из папки, которую обычно назsвают "smartplayer". Она содержит всю docker-сборку, в том числе и файл ".env".\|warn}}

N.Bloshkin в 13:26, 12 февраля 2025

2025-02-12T13:26:31Z

@@ Строка 23: / Строка 23: @@
 === '''Тестирование миграций''' ===
 Перед обновлением серверного приложения на машине пользователя следует провести тестирование миграций по инструкции, запросить которую можно у специалиста технической поддержки SmartPlayer.
 === '''Обновление серверного приложения на машине заказчика''' ===
 {{Note|Команды, указанные в данной инструкции выполняются из папки, которую обычно назsвают "smartplayer". Она содержит всю docker-сборку, в том числе и файл ".env".|warn}}
@@ Строка 66: / Строка 108: @@
 <code>docker-compose start web</code>
 * Осуществить проверку работоспособности сервера и ЛК, запросив у специалистов технической поддержки специальный чек-лист проверки работоспособности сервера и личного кабинета после установки обновления
 == '''Обновление личного кабинета''' ==
 * Загрузить архив с личным кабинетом на машину пользователя доступным способом
@@ Строка 77: / Строка 118: @@
 <code>unzip frontend_2.103.23_api.smartplayer.org.zip -d cms/cms</code>
 * Осуществить проверку работоспособности сервера и ЛК, запросив у специалистов технической поддержки специальный чек-лист проверки работоспособности сервера и личного кабинета после установки обновления
 == '''"Откат" серверного приложения на прежнюю версию''' ==
 * Убедиться, что "pm2" процессы остановлены:

N.Bloshkin: /* Обновление личного кабинета */

2025-02-12T12:39:24Z

Обновление личного кабинета

← Предыдущая версия		Версия от 15:39, 12 февраля 2025
Строка 71:		Строка 71:
	* Зайти в личный кабинет и зафиксировать какие компоненты системы работают, какие нет, сколько устройств онлайн/оффлайн		* Зайти в личный кабинет и зафиксировать какие компоненты системы работают, какие нет, сколько устройств онлайн/оффлайн
	* Создать бэкап старой версии личного кабинета:		* Создать бэкап старой версии личного кабинета:
	<code>FRONTEND_BACKUP_DIR=$(date +"cms/cms_%Y%m%d%H%M%S") && \</code>		<code>FRONTEND_BACKUP_DIR=$(date +"cms/cms_%Y%m%d%H%M%S") && \</code><br>
	<code>mkdir "$FRONTEND_BACKUP_DIR" && \</code>		<code>mkdir "$FRONTEND_BACKUP_DIR" && \</code><br>
	<code>mv cms/cms/{,.[^.]} "$FRONTEND_BACKUP_DIR"</code>		<code>mv cms/cms/{,.[^.]} "$FRONTEND_BACKUP_DIR"</code>
	* Распаковать ЛК новой версии:		* Распаковать ЛК новой версии:
	<code>unzip frontend_2.103.23_api.smartplayer.org.zip -d cms/cms</code>		<code>unzip frontend_2.103.23_api.smartplayer.org.zip -d cms/cms</code>
	* Осуществить проверку работоспособности сервера и ЛК, запросив у специалистов технической поддержки специальный чек-лист проверки работоспособности сервера и личного кабинета после установки обновления		* Осуществить проверку работоспособности сервера и ЛК, запросив у специалистов технической поддержки специальный чек-лист проверки работоспособности сервера и личного кабинета после установки обновления

	== '''"Откат" серверного приложения на прежнюю версию''' ==		== '''"Откат" серверного приложения на прежнюю версию''' ==
	* Убедиться, что "pm2" процессы остановлены:		* Убедиться, что "pm2" процессы остановлены:

N.Bloshkin: /* "Откат" серверного приложения на прежнюю версию */

2025-02-12T12:39:07Z

"Откат" серверного приложения на прежнюю версию

← Предыдущая версия		Версия от 15:39, 12 февраля 2025
Строка 83:		Строка 83:
	<code>docker exec -it smartplyaer_backend_1 bash -c "pm2 stop all"</code>		<code>docker exec -it smartplyaer_backend_1 bash -c "pm2 stop all"</code>
	* Если осуществлялся запуск миграций, то откатить миграции, восстановив базу данных из дампа:		* Если осуществлялся запуск миграций, то откатить миграции, восстановив базу данных из дампа:
	<code>source .env</code>		<code>source .env</code><br>
	<code>zcat dumpfile.sql.gz \| docker exec -i smartplayer_mysql_1 mysql -u $MYSQL_USER -p$MYSQL_PASSWORD $MYSQL_DATABASE</code>		<code>zcat dumpfile.sql.gz \| docker exec -i smartplayer_mysql_1 mysql -u $MYSQL_USER -p$MYSQL_PASSWORD $MYSQL_DATABASE</code>
	* Вернуть папки "logs", "public", "assets" в бэкап		* Вернуть папки "logs", "public", "assets" в бэкап

N.Bloshkin: /* Обновление серверного приложения на машине заказчика */

2025-02-12T12:38:33Z

Обновление серверного приложения на машине заказчика

N.Bloshkin в 12:37, 12 февраля 2025

2025-02-12T12:37:19Z

Внесённые изменения

N.Bloshkin в 12:34, 12 февраля 2025

2025-02-12T12:34:42Z

@@ Строка 12: / Строка 12: @@
 Если требуется обновить ЛК, то необходимо  получить у специалиста технической поддержки собранный ЛК той версии, на которую следует обновить ЛК. Если данный шаг не нужен, то его можно пропустить.
 == '''Передача файлов''' ==
-Собранные архивы серверного приложения, node modules, ЛК следует разместить на машине заказчика. Перед обновлением серверного приложения проводится тестирований миграций (см соответствующий раздел), для чего с машины заказчика снимается дамп БД и переносится на тестовую машину.
+Собранные архивы серверного приложения, node modules, ЛК следует разместить на машине заказчика. Перед обновлением серверного приложения проводится тестирований миграций, для чего с машины пользователя снимается дамп базы данных и переносится на тестовую машину.

← Предыдущая версия		Версия от 09:27, 2 февраля 2026
Строка 61:		Строка 61:
	=== '''Обновление серверного приложения на машине заказчика''' ===		=== '''Обновление серверного приложения на машине заказчика''' ===
	Команды, указанные в данной инструкции, выполняются от имени пользователя smartplayer и папки, которую обычно называют smartplayer, она содержит всю сборку, в том числе и файл '''.env и docker-compose.yml'''		Команды, указанные в данной инструкции, выполняются от имени пользователя smartplayer и папки, которую обычно называют smartplayer, она содержит всю сборку, в том числе и файл '''.env и docker-compose.yml'''
	[[File:~~Консоль отображение~~ 1.png\|thumb\|center\| Пример отображения в консоли\|800px]]		[[File:Скриншот 1.png\|thumb\|center\| Пример отображения в консоли\|800px]]
	Если приложение установлено под пользователем с root-правами, тогда и обновление необходимо производить под этим пользователем. Владельца приложения можно определить по выводу команды '''ls''' (на скриншоте выше). Необходимо зайти в личный кабинет и зафиксировать какие компоненты системы работают/не работают, а также сколько устройств онлайн/оффлайн.		Если приложение установлено под пользователем с root-правами, тогда и обновление необходимо производить под этим пользователем. Владельца приложения можно определить по выводу команды '''ls''' (на скриншоте выше). Необходимо зайти в личный кабинет и зафиксировать какие компоненты системы работают/не работают, а также сколько устройств онлайн/оффлайн.
	Следующим шагом остановите nginx с помощью команды:<br>		Следующим шагом остановите nginx с помощью команды:<br>
	<code> docker-compose stop web </code><br>		<code> docker-compose stop web </code><br>
	[[File:~~Консоль отображение 1~~.png\|thumb\|center\| Пример отображения в консоли\|800px]]		[[File:Обновление_докера.png\|thumb\|center\| Пример отображения в консоли\|800px]]
	Далее необходимо остановить серверное приложение с помощью команды:<br>		Далее необходимо остановить серверное приложение с помощью команды:<br>
	<code> docker exec -it smartplayer_backend_1 bash -c "pm2 stop all" </code><br>		<code> docker exec -it smartplayer_backend_1 bash -c "pm2 stop all" </code><br>
	[[File:~~Консоль отображение 1~~.png\|thumb\|center\| Пример отображения в консоли\|800px]]		[[File:Остановка_серверного_приложения.png\|thumb\|center\| Пример отображения в консоли\|800px]]
	Создаем дамп базы данных:<br>		Создаем дамп базы данных:<br>
	<code>./mysql_backup/mysql_backup.sh</code><br>		<code>./mysql_backup/mysql_backup.sh</code><br>
	Также проверяем дамп что он не пустой:<br>		Также проверяем дамп что он не пустой:<br>
	<code> ls -lah1 ./data/mysql-dumps/ </code><br>		<code> ls -lah1 ./data/mysql-dumps/ </code><br>
	[[File:~~Консоль отображение 1~~.png\|thumb\|center\| Пример отображения в консоли\|800px]]		[[File:Проверка_базы_данных.png\|thumb\|center\| Пример отображения в консоли\|800px]]
	Создать бэкап старой версии серверного приложения.<br>		Создать бэкап старой версии серверного приложения.<br>
	Ниже приведена последовательность команд, которая создает папку ''/backend/app_v_version, где version'' — это номер версии серверного приложения (получаемый из файла package.json), в которую переносит содержимое папки ''/backend/app/''.<br>		Ниже приведена последовательность команд, которая создает папку ''/backend/app_v_version, где version'' — это номер версии серверного приложения (получаемый из файла package.json), в которую переносит содержимое папки ''/backend/app/''.<br>
Строка 84:		Строка 84:
	Произвести проверку содержимого папки с созданной копией:<br>		Произвести проверку содержимого папки с созданной копией:<br>
	<code>ls -la $SERVER_APP_BACKUP_DIR</code><br>		<code>ls -la $SERVER_APP_BACKUP_DIR</code><br>
	[[File:~~Консоль отображение 1~~.png\|thumb\|center\| Пример отображения в консоли\|800px]]		[[File:Проверка_содержимого.png\|thumb\|center\| Пример отображения в консоли\|800px]]
	Содержимое папки ''/backend/app/'' должно быть пустым, за исключением папки ''logs'':<br>		Содержимое папки ''/backend/app/'' должно быть пустым, за исключением папки ''logs'':<br>
	<code>ls -la ./backend/app/</code><br>		<code>ls -la ./backend/app/</code><br>
	[[File:~~Консоль отображение 1~~.png\|thumb\|center\| Пример отображения в консоли\|800px]]		[[File:Сравнение_содержимого.png\|thumb\|center\| Пример отображения в консоли\|800px]]
	Создаётся бэкап старой версии личного кабинет:<br>		Создаётся бэкап старой версии личного кабинет:<br>
	<code> FRONTEND_BACKUP_DIR=$(date +"cms/cms_%Y%m%d%H%M%S")</code><br>		<code> FRONTEND_BACKUP_DIR=$(date +"cms/cms_%Y%m%d%H%M%S")</code><br>
Строка 97:		Строка 97:
	Содержимое папки ''/cms/cms/'' должно быть пустым:		Содержимое папки ''/cms/cms/'' должно быть пустым:
	<code>ls -la ./cms/cms/</code>		<code>ls -la ./cms/cms/</code>
	[[File:~~Консоль отображение 1~~.png\|thumb\|center\| Пример отображения в консоли\|800px]]		[[File:Проверка_содержимиого.png\|thumb\|center\| Пример отображения в консоли\|800px]]
	== '''Обновление файлов серверного приложения''' =		== '''Обновление файлов серверного приложения''' =
	Разархивируем .zip-архив в папку ''update'':<br>		Разархивируем .zip-архив в папку ''update'':<br>
Строка 103:		Строка 103:
	Копируем из папки ''/update/cms/'' все файлы в папку ''/cms/cms/'':		Копируем из папки ''/update/cms/'' все файлы в папку ''/cms/cms/'':
	<code>cp -r ./update/cms/. ./cms/cms/</code><br>		<code>cp -r ./update/cms/. ./cms/cms/</code><br>
	[[File:~~Консоль отображение 1~~.png\|thumb\|center\| Пример отображения в консоли\|800px]]		[[File:Копирование_1.png\|thumb\|center\| Пример отображения в консоли\|800px]]
	Копируем из папки ''/update/server/'' все файлы в папку ''/backend/app/'':<br>		Копируем из папки ''/update/server/'' все файлы в папку ''/backend/app/'':<br>
	<code>cp -r ./update/server/. ./backend/app/</code><br>		<code>cp -r ./update/server/. ./backend/app/</code><br>
	[[File:~~Консоль отображение 1~~.png\|thumb\|center\| Пример отображения в консоли\|800px]]		[[File:Копирование_2.png\|thumb\|center\| Пример отображения в консоли\|800px]]
	Копируем из папки ''/update/serverAdminLicensing/'' все файлы в папку ''/cms/admin/'':		Копируем из папки ''/update/serverAdminLicensing/'' все файлы в папку ''/cms/admin/'':
	<code>cp -r ./update/serverAdminLicensing/. ./cms/admin/</code><br>		<code>cp -r ./update/serverAdminLicensing/. ./cms/admin/</code><br>
Строка 112:		Строка 112:
	<code>cp -r ./update/widgets/. ./widgets/</code><br>		<code>cp -r ./update/widgets/. ./widgets/</code><br>
	Переносим папки и конфигурации из архива в новую версию: '''logs, pm2.app.config.js, config/*'''.		Переносим папки и конфигурации из архива в новую версию: '''logs, pm2.app.config.js, config/*'''.
	{{Note\|default.js и default.schema.json затирать не надо, используем ключ -n\|warn}}		{{Note\|default.js и default.schema.json затирать не надо, используем ключ ''-n''\|warn}}
	<code> cp -t backend/app "$SERVER_APP_BACKUP_DIR/pm2.app.config.js"</code><br>		<code> cp -t backend/app "$SERVER_APP_BACKUP_DIR/pm2.app.config.js"</code><br>
	<code>cp -n -R -t backend/app/config $SERVER_APP_BACKUP_DIR/config/* </code><br>		<code>cp -n -R -t backend/app/config $SERVER_APP_BACKUP_DIR/config/* </code><br>
	[[File:~~Консоль отображение 1~~.png\|thumb\|center\| Пример отображения в консоли\|800px]]		[[File:Перенос_с_ключом.png\|thumb\|center\| Пример отображения в консоли\|800px]]
	{{Note\|После обновления файлов серверного приложения, в случае, если для обновления серверного приложения требуется обновление контейнеров docker, запускаем скрипт обновления контейнеров и изменения конфигураций (migrate_to_new_structure_dv_*.run)\|warn}}		{{Note\|После обновления файлов серверного приложения, в случае, если для обновления серверного приложения требуется обновление контейнеров docker, запускаем скрипт обновления контейнеров и изменения конфигураций (migrate_to_new_structure_dv_*.run)\|warn}}
	Перезапускаем docker-compose:<br>		Перезапускаем docker-compose:<br>
Строка 122:		Строка 122:
	<code>docker exec -i smartplayer_backend_1 bash -c "LOG_LEVEL=DEBUG ./cli.js db migrate" > mig_2024.03.24.log 2> migration_error.log</code><br>		<code>docker exec -i smartplayer_backend_1 bash -c "LOG_LEVEL=DEBUG ./cli.js db migrate" > mig_2024.03.24.log 2> migration_error.log</code><br>
	Если миграции завершились логом "'''All migrations are rolled.'''", то они выполнены успешно. Если нет, то обратиться к представителю компании SmartPlayer для дальнейший переадресации проблемы в команду разработку, чтобы выяснить причину не произошедшей миграции.		Если миграции завершились логом "'''All migrations are rolled.'''", то они выполнены успешно. Если нет, то обратиться к представителю компании SmartPlayer для дальнейший переадресации проблемы в команду разработку, чтобы выяснить причину не произошедшей миграции.
	[[File:~~Консоль отображение 1~~.png\|thumb\|center\| Пример отображения в консоли\|800px]]		[[File:Завершение_миграции.png\|thumb\|center\| Пример отображения в консоли\|800px]]
	Выполняем миграции Mongo:<br>		Выполняем миграции Mongo:<br>
	<code>docker exec $(docker ps -q -f name=backend \| head -n1) bash -c "./cli.js db mongo-migrate"</code><br>		<code>docker exec $(docker ps -q -f name=backend \| head -n1) bash -c "./cli.js db mongo-migrate"</code><br>
Строка 128:		Строка 128:
	Для этого, в течении двух минут вызывать список процессов '''pm2''' и убедиться, что процессы не «падают» (в поле '''uptime''' время должно расти. В соседнем поле, обозначающем количество перезапусков, значение изменяться не должно):<br>		Для этого, в течении двух минут вызывать список процессов '''pm2''' и убедиться, что процессы не «падают» (в поле '''uptime''' время должно расти. В соседнем поле, обозначающем количество перезапусков, значение изменяться не должно):<br>
	<code>docker exec -it smartplayer_backend_1 bash -c "pm2 list"</code><br>		<code>docker exec -it smartplayer_backend_1 bash -c "pm2 list"</code><br>
	[[File:~~Консоль отображение 1~~.png\|thumb\|center\| Пример отображения в консоли\|800px]]		[[File:Проверка_количеества_перезапусков.png\|thumb\|center\| Пример отображения в консоли\|800px]]
	Произвести проверку работы личного кабинета. Количество устройств on-line должно равняться количеству устройств в сети до обновления.		Произвести проверку работы личного кабинета. Количество устройств on-line должно равняться количеству устройств в сети до обновления.
	Удаление файлов обновления:<br>		Удаление файлов обновления:<br>

← Предыдущая версия		Версия от 15:38, 12 февраля 2025
Строка 49:		Строка 49:
	<code>mv -n -t backend/app "$SERVER_APP_BACKUP_DIR/assets/"</code>		<code>mv -n -t backend/app "$SERVER_APP_BACKUP_DIR/assets/"</code>
	* Перенести старые конфиги (при этом существующие файлы внутри новой сборки "config/default.js" и "config/default.schema.json" удалять не надо):		* Перенести старые конфиги (при этом существующие файлы внутри новой сборки "config/default.js" и "config/default.schema.json" удалять не надо):
	<code>cp -t backend/app "$SERVER_APP_BACKUP_DIR/pm2.app.config.js" "$SERVER_APP_BACKUP_DIR/.init-db"</code>		<code>cp -t backend/app "$SERVER_APP_BACKUP_DIR/pm2.app.config.js" "$SERVER_APP_BACKUP_DIR/.init-db"</code><br>
	<code>cp -n -R -t backend/app/config $SERVER_APP_BACKUP_DIR/config/*</code>		<code>cp -n -R -t backend/app/config $SERVER_APP_BACKUP_DIR/config/*</code>
	* Дополнить параметры в конфигурационных файлах при необходимости.		* Дополнить параметры в конфигурационных файлах при необходимости.
	* Выполнить миграции с записью вывода в файл:		* Выполнить миграции с записью вывода в файл:
	<code>MIG_LOG_FILE_NAME=$(date +"./mig_%Y%m%d%H%M%S.log") && \</code>		<code>MIG_LOG_FILE_NAME=$(date +"./mig_%Y%m%d%H%M%S.log") && \</code><br>
	<code>docker exec -i smartplayer_backend_1 bash -c "LOG_LEVEL=DEBUG ./cli.js db migrate" &> "$MIG_LOG_FILE_NAME"</code>		<code>docker exec -i smartplayer_backend_1 bash -c "LOG_LEVEL=DEBUG ./cli.js db migrate" &> "$MIG_LOG_FILE_NAME"</code>
	* Отслеживать ход выполнения миграций командой:		* Отслеживать ход выполнения миграций командой:
Строка 66:		Строка 66:
	<code>docker-compose start web</code>		<code>docker-compose start web</code>
	* Осуществить проверку работоспособности сервера и ЛК, запросив у специалистов технической поддержки специальный чек-лист проверки работоспособности сервера и личного кабинета после установки обновления		* Осуществить проверку работоспособности сервера и ЛК, запросив у специалистов технической поддержки специальный чек-лист проверки работоспособности сервера и личного кабинета после установки обновления

	== '''Обновление личного кабинета''' ==		== '''Обновление личного кабинета''' ==
	* Загрузить архив с личным кабинетом на машину пользователя доступным способом		* Загрузить архив с личным кабинетом на машину пользователя доступным способом