Пути по ролям

Документация организована по режимам Diátaxis — учебники, практические руководства, справочник, объяснение — потому что именно так документация остаётся пригодной. Но люди приходят с ролью, а не с режимом. Вот пять путей через одни и те же страницы, в порядке чтения.

Платформенная инженерия — установить, эксплуатировать

Вы владеете развёртыванием: аптайм, резервные копии, обновления, ёмкость.

1. Увидеть в работе: быстрый старт (пять минут), затем учебник zero-to-graph, если хотите управляемую версию.
2. Установить по-настоящему, по сценарию: один узел (systemd) · Docker Compose · Kubernetes/Helm с HA · air-gapped.
3. Подключить сигналы: подключить источник, затем руководства по коннекторам (pgAudit, CloudTrail, eBPF/Tetragon).
4. Эксплуатировать: мониторинг и SLO · резервное копирование и восстановление · устранение неполадок.

Справочник, в котором вы будете жить: конфигурация, CLI, коннекторы и уровни.

Инженерия безопасности — управлять, сдерживать

Вы владеете наименьшими привилегиями, применением и реагированием на инциденты для estate агентов.

1. Сначала модель: что такое access map и честность и ограничения — что продукт будет и что не будет заявлять.
2. Управлять: управление и согласование (RBAC, restrict-only PDP, записанные решения), затем рецепты: deny-closed-политики · HITL-согласования · разбор дрейфа.
3. Применять на поверхности агента: хуки Claude Code и PEP · управление MCP · бюджеты как guardrails.
4. Сдерживать: учения с аварийным выключателем и закалка развёртывания.

Глубокая теория: модель безопасности и модель угроз.

Комплаенс — доказательства, аудит, резидентность

Вы отвечаете перед аудиторами и регуляторами; вам нужны записи, которые доказывают сами себя.

1. Что является доказательством: гарантия записанных решений в управлении и согласовании — работающий только на добавление, подписанный журнал под каждым решением.
2. Вынести его наружу: протолкнуть в ваш SIEM или вытянуть/прочитать его хвост для WORM-архивирования — и проверить его офлайн (устранение неполадок § журнал).
3. Сохранить его живучим: резервное копирование и восстановление — безопасные для непрерывности пакеты, правило хранения ключа вне коробки, учения по восстановлению.
4. Резидентность и происхождение: air-gapped-эксплуатация · проверка релиза · open core и лицензирование.

Честная база для ссылок в оценках: Честность и ограничения — что работает, что по требованию, что на стадии проектирования.

Самостоятельный запуск — одна машина, один человек

Нет ни платформенной команды, ни отдела комплаенса: homelab, домашний сервер или установка для фрилансера либо малого бизнеса, где устанавливает и использует продукт один и тот же человек. Здесь нет уменьшенной версии продукта — это тот же единый бинарник, а страницы расположены в порядке, который быстрее всего делает одну машину полезной.

Развёртывание с Docker Один Compose-файл, один контейнер, ваша собственная машина. Кратчайший путь от ничего до работающей управляющей плоскости.

Быстрый старт Первый запуск, первый агент, первая управляемая сессия — десять минут после старта.

Затраты и бюджеты Сколько стоят ваши модели, по агентам и сессиям, с бюджетами, которые дают ответ раньше счёта.

Резервное копирование и восстановление Та операционная привычка, которую стоит завести с первого дня, кто бы ни владел машиной.

Строители — расширить

Вы пишете коннектор или работаете с API.

Создание и поставка коннектора Каркас, реализация, подпись, распространение — с deny-closed подписанным допуском.

Использование клиентских SDK Клиенты на Go, Java, Python и TypeScript поверх опубликованного контракта REST.

Управление как код Провайдер Terraform/OpenTofu поверх управляемого API.

Справочник по API и событиям Поверхность REST, отрисованная из OpenAPI, и шина событий AsyncAPI.