Docs / Обзор
Digraph Docs
Digraph показывает Docker-инфраструктуру как живой граф: контейнеры, сети и тома, трафик и нагрузку, историю и инциденты — плюс управление, секреты, бэкапы и AI-разбор. Документация описывает установку, архитектуру, API и эксплуатацию.
Что такое Digraph
Продукт состоит из двух слоёв. Контур — инсталляция рядом с Docker-демоном: она собирает состояние, хранит историю в SQLite и выполняет действия. Портал — отдельное приложение на своём домене: вход пользователей, инвентарь контуров и прокси к их API.
docker-api — единственный держатель сокетаРежимы работы
| Что | Standalone | Портал |
|---|---|---|
| Вход | AUTH_TOKEN на контуре | JWT портала: OIDC SSO или токен |
| UI | Отдаёт контур | Отдаёт портал, API — через прокси |
| AI | Ключ и вызовы на контуре | Ключ и вызовы на портале |
| SSO | OIDC на контуре (опционально) | OIDC на портале; контур принимает только токен |
| Контуры | Один | Несколько, с общим инвентарём |
| Данные | Состояние, история и настройки остаются на контуре | |
Быстрый старт
Нужен Docker с Compose v2. Образы публикуются в hub.docker-infra.ru/digraph, pull работает без логина:
cd deploy/contour
cp .env.example .env # VERSION=v0.1.0, HOST_IP
./init-secrets.sh
docker compose pull
docker compose up -d
curl http://localhost:9090/api/readyПортал: cd deploy/portal && cp .env.example .env && ./init-secrets.sh && docker compose up -d.
| Сервис | Порт | Что это |
|---|---|---|
| Контур | 9090 | API и WebSocket; UI отдаёт портал |
| Портал | 9091 | Loopback по умолчанию; наружу — через TLS-прокси |
| Reverse proxy | 80, 443 | HTTPS для портала и сайтов |
Версии. Версия фиксируется в .env (VERSION). Обновление — docker compose pull && docker compose up -d, откат — предыдущий тег. Образы: hub.docker-infra.ru/digraph/<image>:<version>.
Fail-closed auth. Без AUTH_TOKEN (или файла secrets/auth_token) приложение не стартует. Короткие и известные значения вроде changeme тоже считаются ошибкой.
Ключевые понятия
| Термин | Значение |
|---|---|
| Срез | Состояние графа на момент изменения; к нему сохраняются метрики и хвосты логов |
| PRIVILEGES | Единый переключатель прав: read-only (по умолчанию), all или список actions,exec,push,compose |
| Токен контура | AUTH_TOKEN, которым портал ходит в контур; в браузер не попадает |
| Sidecar | Сервис рядом с контуром: агент Docker, compose-runner, сканеры томов и уязвимостей, метрики хоста |
| Кластер проекта | Группа контейнеров одного compose-проекта на графе |