
simplement des nœuds et des graphes
Visualisez votre infrastructure. Zéro configuration.
Pointez graph-go vers votre stack et obtenez une carte interactive et en direct de chaque base de données, table, service et bucket de stockage — avec une surveillance de l'état en temps réel.
graph-go est un cartographe d'infrastructure orienté CLI. Il découvre automatiquement votre infrastructure en se connectant au démon Docker, en inspectant les conteneurs en cours d'exécution et en sondant les bases de données et les services de stockage. L'interface est servie par le backend et reflète l'état réel du backend — aucun inventaire manuel n'est nécessaire.
| Capacité | Détails |
|---|---|
| Découverte automatique | Détecte l'infrastructure à partir des conteneurs Docker et des clusters Kubernetes — aucun inventaire manuel nécessaire |
| Kubernetes | Namespaces, Deployments, StatefulSets, DaemonSets, Pods, Services — avec une surveillance en temps réel basée sur les informers |
| Docker | Classe les conteneurs en cours d'exécution, extrait les identifiants, surveille les événements Docker, respecte les labels graphgo.* pour remplacer le type/DSN/type de nœud/nom ou ignorer un conteneur |
| PostgreSQL | Tables, relations de clés étrangères, topologie du schéma |
| MongoDB | Bases de données et collections |
| MySQL | Tables, relations de clés étrangères |
| Redis | Espaces de clés et distribution des clés |
| Elasticsearch | Index, état du cluster, état des shards |
| S3 / MinIO | Buckets et préfixes de premier niveau |
| Services HTTP | Points de terminaison de santé, cartographie des dépendances entre services |
| État en temps réel | Mises à jour d'état en direct via WebSocket toutes les 5 secondes |
| Graphe interactif | Disposition en couloirs (swimlanes), conteneurs de groupes par namespace, panoramique/zoom, filtrage par type/état, recherche de nœuds |
graph-go respecte un petit ensemble de labels de conteneur graphgo.* (définissez-les sur tout conteneur que vous souhaitez contrôler) :
| Label | Effet |
|---|---|
graphgo.ignore=true | Ignorer entièrement ce conteneur |
graphgo.type=postgres | Forcer le type d'adaptateur (postgres, mongodb, mysql, redis, elasticsearch, s3, http) |
graphgo.dsn=... | Injecter une chaîne de connexion (DSN pour postgres/mysql, URI pour mongodb, retombe sur dsn sinon) |
graphgo.node-type=gateway | Remplacer le type visuel du nœud (service, gateway, auth, api, queue, cache) |
graphgo.name=... | Remplacer le nom du nœud affiché dans le graphe et utilisé dans les IDs de nœuds / les logs |
Utilisez-les pour récupérer des conteneurs mal classés, pointer graph-go vers un DSN personnalisé, ou masquer un conteneur du graphe sans le supprimer.
Lancez la stack de démonstration préremplie avec la CLI. C'est le moyen le plus rapide de voir graph-go face à un environnement réaliste et le parcours d'intégration prévu pour les nouveaux utilisateurs :
git clone https://github.com/guilherme-grimm/graph-go.git
cd graph-go
go run ./cmd/app demo
Ouvrez http://localhost:8080. La commande s'exécute en mode attaché via Docker Compose. Appuyez sur Ctrl+C pour arrêter la session attachée.
Le premier lancement peut prendre plusieurs minutes sur une machine froide, car Docker peut avoir besoin de récupérer les images de base et de construire les images de démonstration locales. Les lancements suivants sont bien plus rapides.
La pile de démonstration nécessite que ces ports hôtes soient libres : 8080, 5432, 27017, 9000 et 9001.
Si vous avez besoin d'un démontage explicite par la suite :
docker compose -f docker-compose.demo.yml down
Un conteneur, un port. Montez le socket Docker en lecture seule et graph-go découvre automatiquement tout ce qui s'exécute sur l'hôte :
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
L'image s'exécute en tant qu'utilisateur non-root, donc
--group-addlui accorde le groupe du socket (stat -cest spécifique à Linux ; sur macOS, commencez par--group-add 0). Si la découverte Docker retombe encore sur YAML uniquement, le journal de démarrage indique quoi modifier (y compris la valeur exacte de--group-addlorsque c'est la solution).graph-go ne fait que lire depuis l'API Docker (list, inspect, events).
:rone restreint toutefois pas les appels API : tout ce qui peut atteindre le socket peut contrôler le démon. Pour un privilège minimal, placez un proxy d'API en lecture seule tel quetecnativa/docker-socket-proxydevant le socket et pointez graph-go vers celui-ci avecDOCKER_HOST=tcp://<proxy>:2375(aucun montage de socket ni--group-addnécessaire).docker-compose.demo.ymlmontre une configuration fonctionnelle.
Ouvrez http://localhost:8080. La découverte automatique gère les conteneurs Docker et (lorsqu'un kubeconfig ou un compte de service in-cluster pointe vers un cluster joignable) les ressources Kubernetes sans aucun fichier de configuration.
Pour les services qui résident en dehors de Docker/Kubernetes (bases de données distantes, services cloud managés), montez un fichier de configuration — voir Configuration.
Binaire unique autonome — l'interface utilisateur est intégrée, mais le point d'entrée reste la 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
Ouvrez http://localhost:8080. Autres plateformes sur la page Releases.
Découvrez les outils les plus utilisés par notre communauté.
Pas encore de données de popularité.