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 работает без логина. Исходники не нужны: откройте генератор и скачайте готовый compose и конфиг.
mkdir digraph-contour && cd digraph-contour
# положите сюда docker-compose.contour.yml и digraph.config.enc из генератора
docker compose -f docker-compose.contour.yml pull
docker compose -f docker-compose.contour.yml up -d
curl http://localhost:9090/api/readyПортал — так же, в своём каталоге: docker-compose.portal.yml и тот же digraph.config.enc, затем docker compose -f docker-compose.portal.yml up -d.
| Сервис | Порт | Что это |
|---|---|---|
| Контур | 9090 | API и WebSocket; UI отдаёт портал |
| Портал | 9091 | Loopback по умолчанию; наружу — через TLS-прокси |
| Reverse proxy | 80, 443 | HTTPS для портала и сайтов |
Версии. По умолчанию compose берёт текущий релиз. Обновление — VERSION=v0.2.0 docker compose -f docker-compose.contour.yml pull и up -d либо .env с нужным тегом; откат — предыдущий тег. Образы: hub.docker-infra.ru/digraph/<image>:<version>.
Fail-closed auth. Без токена контура — в зашифрованном конфиге или AUTH_TOKEN — приложение не стартует. Короткие и известные значения вроде changeme тоже считаются ошибкой.
Ключевые понятия
| Термин | Значение |
|---|---|
| Срез | Состояние графа на момент изменения; к нему сохраняются метрики и хвосты логов |
| PRIVILEGES | Единый переключатель прав: read-only (по умолчанию), all или список actions,exec,push,compose |
| Токен контура | AUTH_TOKEN, которым портал ходит в контур; в браузер не попадает |
| Sidecar | Сервис рядом с контуром: агент Docker, compose-runner, сканеры томов и уязвимостей, метрики хоста |
| Кластер проекта | Группа контейнеров одного compose-проекта на графе |