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

53 lines
8.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Операторское окно 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`:
```ts
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-плана, не свидетельство его завершения.