Ochenstarik 23eb3f5233 chore(agents): разбор рабочих папок с диска на 2026-08-18

Задания, отчёты и патчи, лежавшие в C:\Users\Ochenstarik\projects и в
домашней папке, перенесены в agents/. Разложено по агентам там, где имя
файла позволяло определить автора; остальное — в _salvage-2026-08-18/
и разбирается вручную.

Патчи в notes/salvage-2026-08-18/ — незакоммиченная работа из брошенных
рабочих копий: она существовала только на диске.

Тяжёлое (релизные архивы, инсталляторы, наборы данных) в репозиторий не
попало: оно лежит рядом, в Agent_projects/_archive и Agent_projects/_data.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-18 14:19:54 +07:00

8.1 KiB

Raw Permalink Blame History

Codex: режим полного удаления в установщике

Репозиторий

https://github.com/ochenstarik-ui/server-monitor-manager
База: main @ f7b10ac
Ветка: codex/uninstall-mode
main защищён: PR обязателен, обязательны статусы build-and-test и build, force-push запрещён
один PR — одна тема; описание PR заполняется после завершения CI
теги в этом задании не создаются, релиз не выпускается

Задача

В deploy/smm-setup.sh есть интерактивный режим: запуск без аргументов спрашивает роль и ставит Hub или узел. Строка выбора сейчас такая:

Choose role: 1) Hub  2) Node

Нужен третий пункт: удалить систему с этой машины полностью.

Это единственный предмет задания. Установочная часть не переделывается.

Почему существующих команд недостаточно

uninstall-agent, uninstall-control и uninstall-monitor в deploy/ochenstarik-server-monitor-manager.sh снимают свои компоненты, но после них на машине остаётся:

системные пользователи и группы ochenstarik-smm-control, ochenstarik-smm-agent, ochenstarik-monitor;
конфигурация /etc/wireguard/smm0.conf и включённый юнит wg-quick@smm0;
таблица nftables inet ochenstarik_smm и интерфейс smm0;
каталоги состояния под /var/lib/ochenstarik-server-monitor-manager* и /etc/ochenstarik-server-monitor-manager;
запись в /etc/sudoers.d/ochenstarik-smm-control;
файл /etc/sysctl.d/90-ochenstarik-smm-mesh.conf;
вспомогательные файлы в /usr/local/libexec и /usr/local/sbin.

Владелец проходил эту уборку вручную и знает список поимённо. Задача — сделать так, чтобы этого больше не требовалось.

Требования к поведению

Сначала показать, что будет удалено, потом спрашивать. Список строится по фактическому состоянию машины: какие юниты найдены, какие пользователи существуют, есть ли таблица nftables, есть ли интерфейс smm0, какие каталоги непусты. Не печатать шаблон, в котором половина строк не относится к делу.
Подтверждение — набранным словом, а не y/N. Прецедент в проекте есть: uninstall-control требует --confirm-destroy-control. Случайное нажатие не должно сносить Hub вместе с его удостоверяющим центром.
Порядок: сначала остановить службы, потом удалять юниты. Это не педантизм, а известный случай. Юниты удалили при работающем процессе, процесс осиротел, продолжил держать порт 7443, и userdel отказал, потому что у пользователя оставался живой процесс. Правильная последовательность: systemctl disable --now, затем pkill -u по каждому пользователю, пауза, pkill -9 -u, и только после этого удаление файлов и учётных записей.
Идемпотентность. На машине, где ничего не устанавливалось, режим отрабатывает без ошибок, ничего не меняет и возвращает нулевой код.
Ничего чужого. На серверах владельца работает 3x-ui. Удаляются только объекты с собственными именами: юниты ochenstarik-smm-*, три перечисленных пользователя, таблица inet ochenstarik_smm, интерфейс smm0, каталоги под своими путями. Никаких rm -rf по маскам, способным задеть соседа по машине.
Две глубины удаления. Снять программу, сохранив резервные копии и базу Control, либо снести всё вместе с ними. Второе — отдельным подтверждением: вместе с базой уходит удостоверяющий центр, а с ним все выданные сертификаты и вся регистрация узлов. Отменить это будет нечем.
В конце — проверка. Напечатать состояние после уборки: свободны ли порты 7443 и 51820, остались ли маршруты 10.77.0., остались ли юниты ochenstarik-smm-*, остались ли пользователи. Владелец проверяет чистоту именно этими четырьмя вопросами.
Неинтерактивный вариант. Команда с обязательным флагом подтверждения, без вопросов — для скриптов и повторной приёмки. Без флага команда отказывается работать.

Тесты

В tests/bootstrap/:

на машине без установленной системы режим отрабатывает без ошибок и ничего не меняет;
после полной установки и последующего удаления не остаётся ни юнитов, ни пользователей, ни таблицы nftables, ни интерфейса, ни каталогов состояния;
посторонний юнит и посторонний пользователь, созданные до удаления, остаются нетронутыми;
неинтерактивный вариант без флага подтверждения отказывается работать;
удаление при работающих службах не оставляет процессов, удерживающих порты.

Границы

Antigravity ведёт Control и веб-консоль. Не трогать: src/**, .github/workflows/windows-build.yml.

Ваша область: deploy/**, tests/bootstrap/**, docs/linux-bootstrap.md.

Критерий приёмки

третий пункт выбора роли удаляет систему целиком;
перед удалением показан список того, что найдено на машине;
подтверждение требует набранного слова;
службы останавливаются до удаления юнитов;
посторонние объекты не затрагиваются;
две глубины удаления, вторая с отдельным подтверждением;
в конце напечатано состояние машины;
неинтерактивный вариант работает только с флагом подтверждения;
перечисленные тесты присутствуют и проходят;
PR открыт, CI зелёный, PR не смержен до зелёного;
тег не создаётся.

Отчёт

В описании PR, раздельно: что проверено локально, что в CI со ссылками на прогоны, что не проверялось и почему.

8.1 KiB Raw Permalink Blame History Unescape Escape