
просто узлы и графы
Увидьте свою инфраструктуру. Без конфигурации.
Укажите graph-go на ваш стек и получите живую интерактивную карту каждой базы данных, таблицы, сервиса и хранилища — с мониторингом состояния в реальном времени.
graph-go — это инструмент для картирования инфраструктуры, ориентированный на CLI. Он автоматически обнаруживает вашу инфраструктуру, подключаясь к демону Docker, инспектируя запущенные контейнеры и проверяя базы данных и сервисы хранения. UI обслуживается бэкендом и отражает реальное состояние бэкенда — ручная инвентаризация не требуется.
| Возможность | Подробности |
|---|---|
| Автообнаружение | Определяет инфраструктуру по контейнерам Docker и кластерам Kubernetes — ручная инвентаризация не требуется |
| Kubernetes | Namespaces, Deployments, StatefulSets, DaemonSets, Pods, Services — с наблюдением в реальном времени на основе informer |
| Docker | Классифицирует запущенные контейнеры, извлекает учётные данные, отслеживает события Docker, учитывает метки graphgo.* для переопределения типа/DSN/типа узла/имени или игнорирования контейнера |
| PostgreSQL | Таблицы, связи внешних ключей, топология схемы |
| MongoDB | Базы данных и коллекции |
| MySQL | Таблицы, связи внешних ключей |
| Redis | Ключевые пространства и распределение ключей |
| Elasticsearch | Индексы, состояние кластера, статус шардов |
| S3 / MinIO | Бакеты и префиксы верхнего уровня |
| HTTP-сервисы | Эндпоинты проверки состояния, картирование зависимостей между сервисами |
| Состояние в реальном времени | Живые обновления статуса через WebSocket каждые 5 секунд |
| Интерактивный граф | Swimlane-раскладка, групповые контейнеры пространств имён, панорамирование/масштабирование, фильтрация по типу/состоянию, поиск узлов |
graph-go учитывает небольшой набор меток контейнеров graphgo.* (задавайте их на любом контейнере, которым хотите управлять):
| Метка | Эффект |
|---|---|
graphgo.ignore=true | Полностью пропустить этот контейнер |
graphgo.type=postgres | Принудительно задать тип адаптера (postgres, mongodb, mysql, redis, elasticsearch, s3, http) |
graphgo.dsn=... | Внедрить строку подключения (DSN для postgres/mysql, URI для mongodb, иначе используется dsn) |
graphgo.node-type=gateway | Переопределить визуальный тип узла (service, gateway, auth, api, queue, cache) |
graphgo.name=... | Переопределить имя узла, отображаемое в графе и используемое в ID узлов / логах |
Используйте их, чтобы исправить неверно классифицированные контейнеры, указать graph-go на пользовательский DSN или скрыть контейнер из графа без его удаления.
Запустите демонстрационный стек с предзаполненными данными через CLI. Это самый быстрый способ увидеть graph-go в реалистичной среде и рекомендуемый путь знакомства для новых пользователей:
git clone https://github.com/guilherme-grimm/graph-go.git
cd graph-go
go run ./cmd/app demo
Откройте http://localhost:8080. Команда выполняется в присоединённом режиме через Docker Compose. Нажмите Ctrl+C, чтобы остановить присоединённую сессию.
Первый запуск может занять несколько минут на «холодной» машине, поскольку Docker может потребоваться загрузить базовые образы и собрать локальные демонстрационные образы. Последующие запуски выполняются гораздо быстрее.
Демонстрационный стек требует, чтобы эти порты хоста были свободны: 8080, 5432, 27017, 9000 и 9001.
Если вам нужно явно выполнить очистку после этого:
docker compose -f docker-compose.demo.yml down
Один контейнер, один порт. Смонтируйте сокет Docker в режиме только для чтения, и graph-go автоматически обнаружит всё, что запущено на хосте:
docker run -d -p 8080:8080 \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
--group-add "$(stat -c %g /var/run/docker.sock)" \
ghcr.io/guilherme-grimm/graph-go:latest
Образ запускается от имени непривилегированного пользователя, поэтому
--group-addпредоставляет ему группу сокета (stat -c— это Linux; на macOS начинайте с--group-add 0). Если обнаружение Docker всё ещё откатывается к режиму только YAML, в журнале запуска указано, что нужно изменить (включая точное значение--group-add, если это и есть решение).graph-go только читает из Docker API (list, inspect, events). Однако
:roне ограничивает вызовы API: всё, что может обратиться к сокету, может управлять демоном. Для минимальных привилегий поставьте перед сокетом прокси API только для чтения, напримерtecnativa/docker-socket-proxy, и направьте graph-go на него черезDOCKER_HOST=tcp://<proxy>:2375(монтирование сокета или--group-addне требуются).docker-compose.demo.ymlпоказывает рабочую конфигурацию.
Откройте http://localhost:8080. Автообнаружение обрабатывает контейнеры Docker и (когда kubeconfig или сервисная учётная запись внутри кластера указывают на доступный кластер) ресурсы Kubernetes без какого-либо файла конфигурации.
Для сервисов, находящихся вне Docker/Kubernetes (удалённые базы данных, управляемые облачные сервисы), смонтируйте файл конфигурации — см. Configuration.
Единый самодостаточный бинарный файл — UI встроен, но точкой входа по-прежнему остаётся CLI.
# Linux amd64 (requires the GitHub CLI; browse Releases for other platforms)
gh release download --repo guilherme-grimm/graph-go --pattern 'graph-go_*_linux_amd64.tar.gz' --clobber
tar xzf graph-go_*_linux_amd64.tar.gz
./graph-go serve # or just `./graph-go` - same thing
Откройте http://localhost:8080. Другие платформы — на странице релизов.