53 lines
8.1 KiB
Markdown
53 lines
8.1 KiB
Markdown
# Операторское окно 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-плана, не свидетельство его завершения.
|