Run first-update log maintenance outside restricted Hub service

This commit is contained in:
kzolotarev95 committed 2026-11-20 01:24:44 +04:00
1 parent 780d036a9c
commit f4ccbf82f3
4 files changed
+94 -6

No files matched your search

+16
View File
@@ -101,6 +101,14 @@ journald, ротация и активность таймера. Успех по
API роутеров продолжают работать. Нестандартная конфигурация вызывает ошибку
с причиной и откат, а не ложное сообщение об успехе.
Установка обслуживания при первом переходе запускается через отдельную службу
`owrt-remote-log-maintenance-<id>` у системного systemd. Ограничение
`CapabilityBoundingSet=CAP_NET_BIND_SERVICE` у веб-службы Hub сохраняется:
проверка Nginx и ротация выполняются с системными правами в отдельной задаче.
Права и владельцы `/var/log/nginx/*.log` не меняются ради обхода ошибок доступа.
Предупреждение Nginx `protocol options redefined` само по себе не означает
отказ; итог определяется кодом возврата команды и её сообщением об ошибке.
Если после нажатия кнопки страница продолжает показывать прежнюю сборку,
обновить её через Ctrl+F5. Номер версии остаётся v121; новая сборка определяется
по SHA256. Отдельные команды установки выше сохраняются для ручного применения.
@@ -233,6 +241,14 @@ Python `invalid escape sequence '\s'` в другом HTML-шаблоне Hub н
новых настроек: копия текущего обновления успешно вернула исходные файлы,
Hub продолжил работать, а результат обновления содержит причину отказа.
Отдельно воспроизведён `Permission denied` у `nginx -T` при ограничении
`CapabilityBoundingSet=CAP_NET_BIND_SERVICE`, используемом штатной службой Hub.
С этим же ограничением первый переход со старой сборки через кнопку успешно
установил обслуживание в отдельной задаче systemd. Ограничение Hub, владелец
и режим `www-data:adm 0640` журнала Nginx, ключи/настройки и целостность SQLite
сохранены. Проверены 9 регрессий установки компонентов, 19 проверок обновления
и 6 проверок локального тестового обновления.
Разработчикам: после изменения `vps/log-maintenance.py` выполнить
`python scripts/embed-log-maintenance.py`; команда с `--check` и тесты проверяют,
что встроенный скрипт совпадает с исходником. Внутренний параметр `--backup`
+5 -3
View File
@@ -48,6 +48,7 @@ class UpdateTests(unittest.TestCase):
mock.patch.object(hub, 'hub_update_lock', side_effect=lambda *a, **k: nullcontext()).start()
self.install_logs = mock.patch.object(hub, 'hub_install_log_maintenance').start()
self.rollback_logs = mock.patch.object(hub, 'hub_rollback_log_maintenance').start()
self.bootstrap_logs = mock.patch.object(hub, 'hub_run_log_maintenance_unit').start()
mock.patch.object(hub, 'hub_prune_log_maintenance_backups').start()
def response(self, data=NEW, url=None):
@@ -247,7 +248,7 @@ class UpdateTests(unittest.TestCase):
job = {'id': 'a' * 32, 'status': 'restarting', 'revision': hub.HUB_LOADED_REVISION,
'started_at': hub.time.time()}
hub.hub_update_state(self.directory, job)
self.install_logs.side_effect = None
self.bootstrap_logs.side_effect = None
captured = {}
def thread(**kwargs):
captured['install'] = kwargs['target']
@@ -258,8 +259,9 @@ class UpdateTests(unittest.TestCase):
self.assertEqual(self.manager.snapshot()['job']['status'], 'installing')
captured['install']()
self.assertEqual(self.manager.log_maintenance_status, 'ready')
self.install_logs.assert_called_once_with(self.directory, job['id'], budget=40)
self.install_logs.side_effect = RuntimeError('disk full')
self.bootstrap_logs.assert_called_once_with(self.directory, job['id'], self.target)
self.install_logs.assert_not_called()
self.bootstrap_logs.side_effect = RuntimeError('disk full')
captured['install']()
self.assertEqual(self.manager.snapshot()['job']['status'], 'failed')
self.assertIn('disk full', self.manager.snapshot()['job']['message'])
+32
View File
@@ -92,6 +92,38 @@ class ComponentTests(unittest.TestCase):
self.assertTrue(hub.hub_log_maintenance_directory(self.directory, 'b' * 32).exists())
self.assertTrue(other.exists())
def test_bootstrap_runs_in_separate_system_service_and_checks_receipt(self):
target = self.directory / 'hub.py'
with mock.patch.object(hub.subprocess, 'run', return_value=subprocess.CompletedProcess([], 0, '', '')) as run, \
mock.patch.object(hub, 'hub_log_maintenance_receipt', return_value={
'status': 'ready', 'sha256': hub.HUB_LOG_MAINTENANCE_SHA256}):
hub.hub_run_log_maintenance_unit(self.directory, self.job_id, target)
args = run.call_args.args[0]
self.assertEqual(args[0], 'systemd-run')
self.assertIn('--wait', args)
self.assertIn('--pipe', args)
self.assertIn('panel-log-maintenance-worker', args)
self.assertIn(str(target), args)
self.assertNotIn('--scope', args, 'a scope would inherit restricted Hub capabilities')
self.assertFalse(any('CapabilityBoundingSet' in arg for arg in args))
self.assertEqual(args[-2:], ['--directory', str(self.directory)])
def test_bootstrap_rejects_failed_unit_or_missing_receipt(self):
for status, receipt, message in ((1, {}, 'Permission denied'), (0, {}, 'нет результата')):
with self.subTest(status=status), \
mock.patch.object(hub.subprocess, 'run', return_value=subprocess.CompletedProcess([], status, '', 'Permission denied')), \
mock.patch.object(hub, 'hub_log_maintenance_receipt', return_value=receipt):
with self.assertRaisesRegex(RuntimeError, message):
hub.hub_run_log_maintenance_unit(self.directory, self.job_id, self.directory / 'hub.py')
def test_stale_privileged_worker_never_installs(self):
for job in ({'id': 'd' * 32}, {'id': self.job_id, 'status': 'failed', 'revision': hub.HUB_LOADED_REVISION}):
with mock.patch.object(hub, 'hub_update_state', return_value=job), \
mock.patch.object(hub, 'hub_install_log_maintenance') as install:
with self.assertRaisesRegex(RuntimeError, 'устарела'):
hub.run_hub_log_maintenance_worker(self.job_id, self.directory)
install.assert_not_called()
if __name__ == '__main__':
unittest.main()
+41 -3
View File
@@ -16217,6 +16217,39 @@ def hub_prune_log_maintenance_backups(directory, job_id):
shutil.rmtree(path)
def run_hub_log_maintenance_worker(job_id, directory=None):
directory = Path(directory or STATE_DIR / 'panel-update')
job = hub_update_state(directory)
if (job.get('id') != job_id or job.get('revision') != HUB_LOADED_REVISION
or job.get('status') not in {'restarting', 'succeeded'}):
raise RuntimeError('Задача установки обслуживания журналов устарела.')
hub_install_log_maintenance(directory, job_id, budget=40)
def hub_run_log_maintenance_unit(directory, job_id, target):
"""PID 1 launches the worker outside Hub's restricted capability set.
Keep the worker independent of Hub's service: an old updater can roll back
the Hub while this unit safely finishes restoration of logging settings.
Never chmod nginx logs or broaden the web service's capabilities.
"""
hub_log_maintenance_directory(directory, job_id) # Validate before naming a unit.
result = subprocess.run([
'systemd-run', '--quiet', '--wait', '--pipe', '--collect',
'--unit=owrt-remote-log-maintenance-' + job_id,
'--property=Type=exec', '--property=RuntimeMaxSec=100',
'--setenv=OWRT_REMOTE_STATE_DIR=' + str(STATE_DIR),
sys.executable, str(target), 'panel-log-maintenance-worker',
'--job-id', job_id, '--directory', str(directory),
], capture_output=True, text=True, errors='replace', timeout=110)
if result.returncode:
detail = ((result.stdout or '') + '\n' + (result.stderr or '')).strip()[-2000:]
raise RuntimeError('Задача обслуживания журналов: rc=' + str(result.returncode) + '; ' + detail)
receipt = hub_log_maintenance_receipt(directory, job_id)
if receipt.get('status') != 'ready' or receipt.get('sha256') != HUB_LOG_MAINTENANCE_SHA256:
raise RuntimeError('Задача обслуживания журналов не подтвердила установку: ' + str(receipt.get('error', 'нет результата'))[:1000])
def hub_update_state(directory, value=None):
path = Path(directory) / 'job.json'
if value is not None:
@@ -16390,9 +16423,9 @@ class HubUpdateManager:
self.log_maintenance_status = 'installing'
def install():
try:
# The old worker's health wait is about a minute. Fail/restore
# within that budget rather than install after its rollback.
hub_install_log_maintenance(self.directory, job['id'], budget=40)
# Hub has only CAP_NET_BIND_SERVICE. Provision via PID 1, like
# the regular updater, so nginx tests/rotation have root caps.
hub_run_log_maintenance_unit(self.directory, job['id'], self.target)
self.log_maintenance_status = 'ready'
try:
hub_prune_log_maintenance_backups(self.directory, job['id'])
@@ -21470,6 +21503,11 @@ def parser():
update_worker.add_argument('--job-id', required=True)
update_worker.set_defaults(func=lambda args: sys.exit(run_hub_update_worker(args.job_id)))
log_worker = sub.add_parser('panel-log-maintenance-worker', help=argparse.SUPPRESS)
log_worker.add_argument('--job-id', required=True)
log_worker.add_argument('--directory', required=True, type=Path)
log_worker.set_defaults(func=lambda args: run_hub_log_maintenance_worker(args.job_id, args.directory))
serve = sub.add_parser("serve", help="run web dashboard")
serve.add_argument("--host", default=os.environ.get("OWRT_REMOTE_BIND", "0.0.0.0"))
serve.add_argument("--port", type=int, default=int(os.environ.get("OWRT_REMOTE_PORT", "8088")))