Add sequential router updates with clear SSH authentication errors
This commit is contained in:
1 parent
d61c99cdbc
commit
e9aa14e080
6 files changed
+1078
-2
No files matched your search
@@ -0,0 +1,65 @@
|
||||
# Обновление всех роутеров из Hub, v117
|
||||
|
||||
В меню владельца «Доступ к Hub» добавлен блок «Обновить все роутеры разом».
|
||||
Ссылка «Открыть терминал обновления» открывает отдельную вкладку. В ней задаются
|
||||
команда установки и один общий SSH-пароль root. При SSH-ключе поле можно оставить
|
||||
пустым. Команда по умолчанию использует `RAW_REPO_BASE` именно этого Hub:
|
||||
GitHub — GitHub, GitVerse — GitVerse.
|
||||
|
||||
Hub запускает одну очередь, по одному роутеру. Имена берутся из Heartbeat
|
||||
(`owrtremote.main.router_name`) и уточняются чтением UCI по SSH перед установкой.
|
||||
Неуспешное подключение, ошибка команды и отсутствие подтверждения различаются.
|
||||
Если SSH отклонил общий пароль, у этого роутера выводится понятная ошибка
|
||||
авторизации: его пароль может отличаться от общего. Обновление на нём не
|
||||
запускается, очередь переходит к следующему. Запрет входа по паролю, отсутствие
|
||||
SSH-ключа и сетевые ошибки отображаются отдельно; сам пароль не показывается.
|
||||
Надпись «Успешно — Советская 30» появляется только при полученном `rc=0`.
|
||||
Код 0 подтверждает выполнение команды, а не проверку всех функций роутера.
|
||||
|
||||
Установка запускается отдельным процессом с `setsid` на роутере, не в shell VPS.
|
||||
При разрыве SSH во время установки Hub запрашивает результат по тому же ID,
|
||||
не повторяя команду. При невозможности получить итог останавливаются оставшиеся
|
||||
обновления, чтобы не запускать другую установку параллельно с неподтверждённой.
|
||||
«Остановить очередь после текущего» не прерывает уже начатую установку.
|
||||
|
||||
Временный каталог задачи расположен в `/tmp/owrt-remote-update-ID` на роутере;
|
||||
вывод ограничен примерно 32 КиБ, на VPS передаётся хвост до 8 КиБ. После получения
|
||||
результата каталог удаляется. При потере связи остаётся ограниченный результат
|
||||
до следующей перезагрузки; нет постоянно работающего сборщика этой задачи.
|
||||
Новый API доступен только владельцу, POST защищён токеном и проверкой Origin.
|
||||
SSH-пароль хранится только в памяти текущего worker, не в БД/журнале/URL/browser
|
||||
storage. Из вывода удаляются пароль и строки с известными форматами секретов.
|
||||
|
||||
Закрытие вкладки не отменяет очередь. После открытия показывается текущее
|
||||
состояние; результаты находятся в памяти VPS до двух часов после завершения.
|
||||
Перезапуск Hub прерывает очередь, но уже запущенный installer на роутере
|
||||
продолжает работу. После перезапуска Hub его итог нужно проверять отдельно.
|
||||
Роутеры с неработающим обратным SSH-туннелем обновить этим способом нельзя.
|
||||
Перед запуском списка устройств нет новых требований к их текущему клиенту.
|
||||
|
||||
## Установка локальной версии на VPS из Windows PowerShell
|
||||
|
||||
```powershell
|
||||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-router-updates.ps1" -Vps "root@193.233.82.38" -Action Install
|
||||
```
|
||||
|
||||
Откат Hub (уже установленные на роутеры версии не откатываются этой командой):
|
||||
|
||||
```powershell
|
||||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-router-updates.ps1" -Vps "root@193.233.82.38" -Action Rollback
|
||||
```
|
||||
|
||||
Резервная копия: `/opt/owrt-remote/owrt-remote-hub.py.bak-before-router-updates-v117`.
|
||||
Не устанавливай/не откатывай Hub, пока его очередь работает.
|
||||
|
||||
## Проверки
|
||||
|
||||
`python -m unittest discover -s tests -p test_router_updates.py -v` проверяет
|
||||
последовательность, код результата, пароль, отказы подключения, обрыв после
|
||||
запуска, остановку очереди, повторный запрос, права/CSRF и ограниченный shell
|
||||
вывод. Реальный task исполняется в MSYS; там адаптирован только отсутствующий
|
||||
`setsid`. Синтаксис проверяется также BusyBox ash. Настоящий Linux `setsid`,
|
||||
Dropbear и обновление физического OpenWrt требуют проверки пользователем.
|
||||
|
||||
`node tests/test_router_updates_ui.cjs` проверяет desktop/mobile, ввод команды,
|
||||
очистку пароля, итоги, сохранение раскрытого вывода и возобновление просмотра.
|
||||
Reference in new issue
Block a user