Files
MikrotikManager/docs/bandwidth-operator-docker-stop.md
T

8.1 KiB
Raw Blame History

Операторское окно bandwidth в Docker-only установке

Опциональный adapter реализован в backend/src/services/bandwidth-operator-docker-stop.ts. createDockerBandwidthOperatorWriterComposition подключает его к существующему операторскому пути: исходный подписанный grant → проверка внешних исполнителей → тот же PostgreSQL lease → регистрация canonical node. Автоматического подключения при старте backend нет.

Поддерживаемая граница

Поддерживается один Linux Docker Engine с закреплёнными daemon ID и Unix socket. Доверенный оператор подписывает полный inventory всех контейнеров этого daemon, включая остановленные и несвязанные с приложением. Все backend, updater и recreation controllers уже должны быть остановлены; их Engine restart policy должна быть no с нулевым retry count. В этой границе Engine запрещает автоматический restart, а остановленные controllers не могут пересоздать backend.

Host/remote supervisors, cron/systemd/CI, другие Engine и внешние workers должны отсутствовать в этой установке. Полноту этой границы подтверждает доверенный оператор. Root, Docker administrators и владельцы инфраструктуры остаются доверенными: HTTP GET не запрещает им вручную изменить policy или запустить контейнер. При наличии внешнего supervisor требуется другой adapter с соответствующим действующим контролем.

Docker Image ID не подтверждает содержимое writable layer или bind mounts. sourceArtifacts — подписанные сведения об исходных материалах, а не результат чтения файлов. Ни подпись inventory, ни пустая БД, ни SQL-lock сами по себе не доказывают остановку исполнителей.

Конфигурация и вызов

Доверенная операторская сборка передаёт существующие config, nodeSource, observationSource и отдельный docker объект типа DockerBandwidthOperatorStopConfig:

const operator = createDockerBandwidthOperatorWriterComposition({
  config: reviewedEnrollmentConfig,
  nodeSource: configuredNodeSource,
  observationSource: trustedObservationSource,
  docker: reviewedDockerConfig,
})
try {
  const receipt = await operator.register({ deadlineAt, signal })
  // Публичный ответ не содержит конфигурацию доступа или приватные ключи.
} finally {
  operator.close()
}

docker содержит socketPath, daemonId, канонический JSON inventory, Ed25519-подпись этого JSON, публичный SPKI PEM и SHA-256 его DER-представления. Ключ и подпись готовятся отдельно; adapter не создаёт ключи. SHA-256 канонического inventory должен совпасть с executorInventorySha256 исходного enrollment grant, installation ID также должен совпасть. Caller/model не выбирает transport или verifier.

Inventory format — mmapp-bandwidth-docker-only-quiescence-v1. Поля и ограничения фиксированы в policySchema adapter. Список контейнеров отсортирован по полным ID; закреплены image ID, Compose project/service и роль. Явно подписываются complete-docker-only-inventory, отсутствие внешних automatic controllers и доверенная граница administrators. Отсутствующий, новый или изменённый контейнер приводит к отказу.

Inventory требует минимум один backend и допускает отсутствие updater; защищённых replicas может быть несколько. Проверяется остановка каждой защищённой replica. Это поддерживает установку без отдельного updater и не разрешает пропустить работающий backend/controller.

Вызов выполняет отдельный одноразовый процесс оператора на Linux host: backend, внутри которого мог бы работать HTTP-handler, в этот момент должен быть остановлен. Это не новый MCP/REST endpoint. Существующие проверки оригинального grant, текущих credentials, source pins, SQL ownership и UNKNOWN/no replay сохраняются.

Что проверяется

Используются только фиксированные Docker API v1.45 GET через закреплённый Unix socket: daemon info, полный container list и двойной inspect каждого контейнера, затем повторные list/info. Active Swarm, чужой daemon, неизвестные контейнеры и изменившаяся конфигурация отклоняются.

У защищённых контейнеров проверяются exited/PID 0, отсутствие running/restarting/paused/dead, restart policy и время завершения относительно исходного grant. Docker socket consumers, parent-directory mounts, Docker host/context environment, privileged/host-PID контейнеры нельзя объявить несвязанными. Read-only mount Docker socket также предоставляет доступ к HTTP API.

Текущий deploy/docker-compose.cdn-mm.yml не является уже подготовленным стендом: backend/updater используют unless-stopped; updater и Traefik имеют Docker socket. Подготовка, остановка, изменение restart policy и восстановление сервисов в этой работе не выполнялись.

Исходный deadline/monotonic horizon и отмена не продлеваются. Неопределённый COMMIT не повторяется. close() закрывает возможности и транспорт, но не запускает сервисы и не меняет Docker.

Приёмка и оставшаяся работа

25 synthetic HTTP tests прошли, включая настоящую existing writer composition с подписанным grant: Docker-проверка проходит до source lease, а несоответствие отказывает до credentials. Тесты adapter не использовали реальный Docker, рабочую БД и CHR. Отдельная read-only инвентаризация Debian-стенда подтвердила четыре контейнера, без updater; остановки и изменения restart policy не выполнялись. Подготовлен проверяемый operating-пакет с собственным PostgreSQL и восстановлением backend; его запуск ожидает отдельного ответа на уже заданный запрос разрешения. Счётчик S3-06 не закрыт: нужны действующий inventory/grant, эксплуатационная приёмка всего окна и проверенный порядок восстановления. Это компонент полного MCP-плана, не свидетельство его завершения.