204 lines
18 KiB
Markdown
204 lines
18 KiB
Markdown
# Обновление панели из Hub (v120)
|
|
|
|
Перед «Поиск роутеров» владелец видит кнопку «Проверить обновление панели».
|
|
Обе кнопки оформлены как остальные элементы шапки и стоят рядом на ПК.
|
|
На мобильных устройствах каждая занимает отдельную строку.
|
|
Подтверждённая актуальная сборка обозначается зелёной кнопкой «Обновление не требуется»,
|
|
без отдельного информационного блока на ПК и мобильном. Кнопка по-прежнему позволяет
|
|
повторно проверить обновление. Доступное обновление обозначается жёлтым.
|
|
Проверка и ошибка проверки остаются нейтральными. Сообщение проверки
|
|
размещено первым блоком панели над шапкой, выровнено по центру и отделено
|
|
от элементов управления отступом. Во всех состояниях текст блока белый,
|
|
рамка полупрозрачная, как у «Открыть группы роутеров», фон прозрачный. Ширина ограничена
|
|
680 пикселями, на ПК сверху добавлен отступ 12 пикселей. На мобильном длинный
|
|
текст переносится без обрезки. Элементы шапки идут последовательно:
|
|
ЦП / ОЗУ / ДИСК, обновление панели, эффекты, поиск роутеров. Кнопки занимают
|
|
отдельные строки одинаковой ширины, включая горизонтальную ориентацию.
|
|
Мобильная кнопка «Поиск роутеров» имеет такую же фиолетовую заливку и белый
|
|
текст, как «Эффекты», в том числе при открытом поиске.
|
|
Между мобильными кнопками обновления, эффектов, поиска, меню Hub, добавления,
|
|
групп и статистики используется единый интервал 8 пикселей. Раскрытые блоки
|
|
отделены тем же интервалом; скрытые элементы не оставляют пустых промежутков.
|
|
|
|
Для локальной установки изменения кнопки и скрытия блока актуальной версии:
|
|
|
|
```powershell
|
|
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-update-status-ui.ps1" -Vps "root@193.233.82.38" -Action Install
|
|
```
|
|
|
|
Скрипт сохраняет отдельную резервную копию `owrt-remote-hub.py.bak-before-update-status-ui-v120`.
|
|
Для отката выполнить ту же команду с `-Action Rollback`. После установки или отката
|
|
обновить страницу через Ctrl+F5.
|
|
Успех подтверждается только при совпадении SHA-256 загруженного файла и сборки,
|
|
которая отвечает на `/health?panel-update=1`. Ответа `{"ok":true}` недостаточно.
|
|
|
|
До публикации локальный файл отличается от репозитория: кнопка может предложить
|
|
опубликованную сборку и при подтверждении заменить ею локальный фикс.
|
|
Чтобы проверить именно зелёную кнопку «Обновление не требуется» без публикации,
|
|
выполнить `test-hub-self-update.ps1 -Action Retest`, подтвердить обновление с источником
|
|
«Локальный тест на VPS (без GitHub)» и дождаться перезагрузки страницы. Обе тестовые
|
|
сборки содержат текущий локальный интерфейс; отдельного блока актуальности после
|
|
перезагрузки быть не должно. Команды подготовки и возврата приведены ниже.
|
|
|
|
При открытии панели запускается общая фоновая проверка исходного файла Hub.
|
|
Проверки кешируются на 5 минут; открытые видимые вкладки опрашивают результат
|
|
раз в минуту. Нажатие кнопки позволяет запросить проверку раньше, с ограничением
|
|
не чаще одного сетевого запроса за 15 секунд. Во время установки статус
|
|
запрашивается раз в 2 секунды. Скрытые вкладки приостанавливают опрос.
|
|
|
|
Сравниваются номер версии и SHA-256 файла: более старая опубликованная версия
|
|
не предлагается и не может быть установлена через кнопку/API. Это сохраняет
|
|
локальную v120, пока в источнике опубликована предыдущая версия. Кнопка остаётся
|
|
зелёной с подписью «Обновление не требуется», отдельного баннера актуальности нет.
|
|
Подсказка кнопки показывает номера установленной и более старой опубликованной
|
|
версии. Ограничение проверяется и перед запуском задачи, и в процессе установки
|
|
до замены файла. Явный откат из PowerShell сохраняет своё прежнее поведение.
|
|
Внутри одной версии по-прежнему сравнивается SHA-256: исправления обнаруживаются
|
|
и при неизменной версии v120. Установка требует подтверждения конкретной сборки.
|
|
Ветка GitHub использует свой `RAW_REPO_BASE`; при переносе в GitVerse необходимо
|
|
сохранить его собственный `RAW_REPO_BASE`. Адрес не принимается от браузера.
|
|
|
|
Обновляется только файл VPS-панели. Процесс запускается отдельной transient-службой
|
|
systemd, сохраняет резервную копию, проверяет размер, UTF-8, синтаксис Python
|
|
и совместимость обновления, затем атомарно заменяет файл. Проверка `/health`
|
|
подтверждает именно SHA-256 новой запущенной сборки. При ошибке после замены
|
|
возвращается предыдущий файл и повторно запускается Hub. Результат сохраняется
|
|
в `STATE_DIR/panel-update/job.json`; предыдущий файл — `previous.py` рядом.
|
|
После успеха страница автоматически перезагружается один раз.
|
|
После перезагрузки сообщение завершённой задачи больше не обещает повторную
|
|
перезагрузку: при подтверждённой актуальности остаётся только зелёная кнопка
|
|
«Обновление не требуется». Следующие проверки и доступные новые сборки
|
|
показывают текущее состояние, даже если сохранена предыдущая успешная задача.
|
|
|
|
Очередь, состояние и резервная копия ограничены одним обновлением. Блокировка
|
|
flock не позволяет запустить две установки; при аварии её освобождает ядро.
|
|
Зависшая или прерванная задача получает явный неподтверждённый результат.
|
|
API доступен только владельцу, POST требует CSRF-токен и проверку Origin.
|
|
|
|
Подтверждение установки открывается встроенным адаптивным баннером панели с
|
|
версией, контрольной суммой, источником и кнопками «Отмена» и «Обновить».
|
|
На мобильном он занимает ширину экрана с безопасными полями, не вызывает
|
|
системное белое окно браузера и не допускает горизонтального переполнения.
|
|
|
|
До публикации этой функции публичный старый Hub может не поддерживать проверку
|
|
сборки после перезапуска. Такая сборка отклоняется до замены файла.
|
|
Сообщение «Сборка в источнике ещё не поддерживает проверяемое обновление из
|
|
панели» означает отсутствие механизма обновления в загруженном файле, а не
|
|
отсутствие новых изменений. При такой ошибке кнопка остаётся нейтральной:
|
|
актуальность установленной сборки не подтверждена.
|
|
|
|
## Проверка через кнопку без публикации
|
|
|
|
Скрипт ниже подготавливает на VPS две временные сборки из текущего локального
|
|
исходника v120. Различается только тестовая отметка, поэтому их SHA-256 разные.
|
|
Первая сборка устанавливается скриптом, вторая предлагается кнопкой обновления.
|
|
Только эти временные сборки читают файл-кандидат на самой VPS вместо GitHub.
|
|
Ссылки установки и `RAW_REPO_BASE` остаются прежними. Данные обычной очереди
|
|
обновления и её резервная копия сохраняются: тест использует отдельный каталог.
|
|
|
|
Подготовить тест из Windows 11 PowerShell:
|
|
|
|
```powershell
|
|
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\test-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Prepare
|
|
```
|
|
|
|
Для повторного теста вместо двух отдельных команд `Restore` и `Prepare`
|
|
используется одна команда. Она возвращает прежний файл, если тест уже был
|
|
подготовлен, затем устанавливает новые тестовые сборки. При ошибке возврата
|
|
второй шаг не выполняется; исходная резервная копия не перезаписывается.
|
|
|
|
```powershell
|
|
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\test-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Retest
|
|
```
|
|
|
|
После `SELF_UPDATE_LOCAL_TEST_READY`:
|
|
|
|
1. Открыть панель владельцем, нажать Ctrl+F5 и дождаться жёлтой кнопки
|
|
«Обновление панели».
|
|
2. Нажать кнопку и подтвердить установку. Источник в подтверждении —
|
|
«Локальный тест на VPS (без GitHub)».
|
|
3. Дождаться результата и автоматической перезагрузки страницы. При успехе
|
|
кнопка станет зелёной.
|
|
|
|
Это настоящая замена файла Hub и перезапуск `owrt-remote` через systemd.
|
|
Сервис кратковременно перезапускается; скачивание с GitHub этим тестом
|
|
не проверяется. Подготовка также перезапускает Hub. При неудаче подготовки
|
|
скрипт возвращает исходный файл и проверяет работоспособность.
|
|
|
|
Проверить установленный файл, результат задачи, активность службы и SHA-256
|
|
запущенной через `/health` сборки:
|
|
|
|
```powershell
|
|
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\test-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Status
|
|
```
|
|
|
|
Успешный итог — `SELF_UPDATE_LOCAL_TEST_PASSED`.
|
|
`SELF_UPDATE_LOCAL_TEST_WAITING` означает, что успех ещё не подтверждён;
|
|
следом выводятся статус задачи и результаты проверки.
|
|
`SELF_UPDATE_LOCAL_TEST_NOT_PREPARED` означает, что каталог теста отсутствует.
|
|
Диагностика показывает `installed_build` (`baseline`, `candidate` или `other`),
|
|
контрольные суммы установленного и реально запущенного файла, а также
|
|
`running_installed_file`. Она не меняет VPS и не показывает ключи. Если сборка
|
|
теста реально запущена, но браузер сообщает об ошибке проверки GitHub, нужно
|
|
сверить VPS, на которую указывает открытый домен, и полный результат подготовки.
|
|
|
|
После проверки вернуть файл, который работал до подготовки теста:
|
|
|
|
```powershell
|
|
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\test-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Restore
|
|
```
|
|
|
|
Ожидается `SELF_UPDATE_LOCAL_TEST_RESTORED`. Скрипт проверяет резервную копию
|
|
`/opt/owrt-remote/self-update-local-test/before.py`, возвращает её, перезапускает
|
|
Hub, проверяет `/health`, затем удаляет только созданные файлы теста.
|
|
Повторная подготовка не перезаписывает существующую резервную копию: сначала
|
|
нужно завершить тест и выполнить `Restore` либо использовать `Retest`.
|
|
После восстановления обычная
|
|
проверка снова использует GitHub; до публикации совместимой сборки исходное
|
|
сообщение о неподдерживаемом обновлении ожидаемо появится снова.
|
|
|
|
## Локальная установка с Windows 11
|
|
|
|
```powershell
|
|
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Install
|
|
```
|
|
|
|
После `HUB_SELF_UPDATE_V120_Install_OK` обновить страницу через Ctrl+F5.
|
|
|
|
Откат локальной установки:
|
|
|
|
```powershell
|
|
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Rollback
|
|
```
|
|
|
|
Используется резервная копия
|
|
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-hub-self-update-v120`.
|
|
|
|
## Проверки
|
|
|
|
```powershell
|
|
python tests/test_hub_update.py -v
|
|
python tests/test_hub_self_update_local.py -v
|
|
python tests/test_update_status_ui_deploy.py -v
|
|
node tests/test_hub_update_ui.cjs
|
|
```
|
|
|
|
Python проверяет загрузку из правильного источника, ошибки сети и синтаксиса,
|
|
неизменную версию, отказ от понижения версии при проверке/API/установке,
|
|
переход на более новую версию, проверку контрольной суммы, сохранение рабочего файла,
|
|
установку и откат, восстановление состояния после перезапуска и права API.
|
|
Перезапуск systemd и ответы health в этих тестах моделируются.
|
|
Отдельный тест локального сценария проверяет реальные файлы и HTTP `/health`
|
|
до и после повторного запуска сервера с новым исходником, успешное обновление,
|
|
возврат исходного файла, сохранение обычного состояния обновления и подготовку
|
|
UTF-8 файлов из Windows PowerShell. Команды systemd в автоматическом тесте
|
|
моделируются; их выполнение на VPS проверяется ручным сценарием выше.
|
|
Тест установки интерфейса использует HTTP `/health` и проверяет отказ при
|
|
ответе другой запущенной сборки или при отсутствии контрольной суммы,
|
|
сохранение резервной копии и автоматический возврат предыдущего файла.
|
|
Браузер проверяет размеры 1280, 980, 320, 390, 430, 844 и 932 пикселя,
|
|
положение статуса над шапкой, перенос текста, размеры мобильных кнопок,
|
|
подтверждение/отмену,
|
|
разрыв связи при перезапуске, результат и отсутствие повторной установки
|
|
или цикла перезагрузок страницы. Сам VPS этими тестами не изменяется.
|