Files
MikrotikManager/docs/mcp-operation-lock-scheduler.md
T

5.6 KiB
Raw Blame History

MCP: владение блокировками и автоматическое расписание

Операция MCP удерживает advisory lock до завершения исполнения. Вложенные application/server configuration locks используют её PostgreSQL-соединение через ограниченный фасад. Фасад принимает только четыре фиксированных SQL-команды блокировки и разблокировки; он не предоставляет произвольный SQL, транзакцию или release. Обычный вызов вне операции сохраняет отдельное получение соединения из пула.

Владелец операции единолично освобождает или уничтожает физическое соединение. Незавершённый заём, параллельное использование, потеря соединения или неопределённый ответ на получение блокировки закрывают область и уничтожают владельца. Запоздалый ACK не возвращает право продолжать работу. Перед terminal applied проверяется действующий владелец и отсутствие незавершённых заёмщиков/SQL. Это устраняет проверенный случай нехватки соединений при вложенных operation/application/server locks и публикации routing measurement в пуле из четырёх соединений.

Потеря владельца не отменяет уже отправленный native HTTP-запрос. Проверка владельца также не является атомарным барьером между всеми writers и native transport; соответствующий общий bandwidth barrier остаётся отдельной задачей.

buildApp создаёт корневую область автоматического scheduler до обработки запросов, включая режим startScheduler:false. Инициализация из действующего или закрытого operation/configuration/verified/request context отклоняется. При обновлении расписания создаются непрозрачные tickets только для фиксированного каталога jobs. Произвольного callback для выхода из контекста нет.

Автоматический job дожидается фактического завершения родительской операции и всех родительских application/server unlock, затем открытия database maintenance gate. Ожидание не считается фоновой работой и не занимает request lease: иначе родительский database drain ожидал бы собственного продолжения. Перед исполнением повторно проверяются поколение расписания и текущие настройки; непосредственно работа получает новый request lease и учитывается в background drain. Повторные ticks одного ticket объединяются до завершения работы. Старые поколения не принимают новое расписание через поздний alert hook.

Автоматический job не наследует человеческое подтверждение изменения настроек. Например, разрешение сохранить расписание speed-проб само по себе не разрешает автоматический bandwidth-вызов, для которого текущая политика требует человека. Ручной запуск scheduler сохраняет свой исходный контекст.

Internet Path хранит конфигурацию и статус сбора в одной строке. MCP-план изменения настроек связывается с enabled, intervalSec, retentionDays и текущим каталогом серверов. Изменение lastCollectedAt, lastDurationMs, lastError или общего updatedAt фоновым сборщиком не меняет этот конфигурационный proof. Изменение любого параметра конфигурации отклоняет старый план до записи. Чтение настроек по-прежнему возвращает статус сбора.

Для локальной проверки npm --prefix backend run test:mcp:operation-locks выполняет тесты lifetime и scheduler. npm --prefix backend run test:mcp:operation-locks:pg самостоятельно создаёт одноразовую PostgreSQL, применяет штатные миграции и проверяет реальные SQL/audit-переходы с localhost RouterOS-стабами. Профиль не выполняет terminal restore, не подключается к CHR и не включает production broker. Полный SQL/HTTP и dump/restore проверяются отдельно через test:mcp:pg -- --restore с PostgreSQL client tools.