
बस नोड्स और ग्राफ़
अपने इंफ्रास्ट्रक्चर को देखें। शून्य कॉन्फ़िग।
graph-go को अपने स्टैक पर इंगित करें और हर डेटाबेस, टेबल, सेवा और स्टोरेज बकेट का लाइव, इंटरैक्टिव मैप प्राप्त करें — रीयल-टाइम हेल्थ मॉनिटरिंग के साथ।
graph-go एक CLI-प्रथम इंफ्रास्ट्रक्चर मैपर है। यह Docker डेमॉन से कनेक्ट करके, चल रहे कंटेनरों का निरीक्षण करके, और डेटाबेस व स्टोरेज सेवाओं की जाँच करके आपके इंफ्रास्ट्रक्चर को स्वतः खोजता है। UI बैकएंड द्वारा सर्व की जाती है और वास्तविक बैकएंड स्थिति को दर्शाती है — किसी मैन्युअल इन्वेंटरी की आवश्यकता नहीं।
| क्षमता | विवरण |
|---|---|
| स्वतः-खोज | Docker कंटेनरों और Kubernetes क्लस्टरों से इंफ्रास्ट्रक्चर का पता लगाता है — किसी मैन्युअल इन्वेंटरी की आवश्यकता नहीं |
| Kubernetes | Namespaces, Deployments, StatefulSets, DaemonSets, Pods, Services — informer-आधारित रीयल-टाइम वॉचिंग के साथ |
| Docker | चल रहे कंटेनरों को वर्गीकृत करता है, क्रेडेंशियल निकालता है, Docker इवेंट्स को वॉच करता है, type/DSN/node-type/name को ओवरराइड करने या किसी कंटेनर को अनदेखा करने के लिए graphgo.* लेबल का सम्मान करता है |
| PostgreSQL | टेबल, फ़ॉरेन की संबंध, स्कीमा टोपोलॉजी |
| MongoDB | डेटाबेस और कलेक्शन |
| MySQL | टेबल, फ़ॉरेन की संबंध |
| Redis | कीस्पेस और की वितरण |
| Elasticsearch | इंडाइसेस, क्लस्टर हेल्थ, शार्ड स्थिति |
| S3 / MinIO | बकेट और टॉप-लेवल प्रीफ़िक्स |
| HTTP सेवाएँ | हेल्थ एंडपॉइंट, सेवाओं के बीच निर्भरता मैपिंग |
| रीयल-टाइम हेल्थ | हर 5 सेकंड में WebSocket-संचालित लाइव स्टेटस अपडेट |
| इंटरैक्टिव ग्राफ़ | स्विमलेन लेआउट, नेमस्पेस ग्रुप कंटेनर, पैन/ज़ूम, type/health द्वारा फ़िल्टर, नोड्स खोजें |
graph-go graphgo.* कंटेनर लेबल के एक छोटे सेट का सम्मान करता है (इन्हें किसी भी कंटेनर पर सेट करें जिसे आप नियंत्रित करना चाहते हैं):
| लेबल | प्रभाव |
|---|---|
graphgo.ignore=true | इस कंटेनर को पूरी तरह छोड़ दें |
graphgo.type=postgres | एडाप्टर प्रकार को बाध्य करें (postgres, mongodb, mysql, redis, elasticsearch, s3, http) |
graphgo.dsn=... | एक कनेक्शन स्ट्रिंग इंजेक्ट करें (postgres/mysql के लिए DSN, mongodb के लिए URI, अन्यथा 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 के माध्यम से attached रूप में चलता है। attached सत्र को रोकने के लिए Ctrl+C दबाएँ।
किसी ठंडी मशीन पर पहला रन कई मिनट ले सकता है क्योंकि Docker को बेस इमेज खींचने और स्थानीय डेमो इमेज बनाने की आवश्यकता हो सकती है। बाद के रन बहुत तेज़ होते हैं।
डेमो स्टैक अपेक्षा करता है कि ये होस्ट पोर्ट मुक्त हों: 8080, 5432, 27017, 9000, और 9001।
यदि आपको बाद में स्पष्ट teardown की आवश्यकता हो:
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 -cLinux है; macOS पर--group-add 0से शुरू करें)। यदि Docker डिस्कवरी अभी भी केवल-YAML पर वापस आ जाती है, तो स्टार्टअप लॉग बताता है कि क्या बदलना है (जिसमें सटीक--group-addमान भी शामिल है जब वही समाधान हो)।graph-go केवल Docker API से पढ़ता है (list, inspect, events)। हालाँकि
:roAPI कॉल को प्रतिबंधित नहीं करता: जो भी सॉकेट तक पहुँच सकता है, वह डेमॉन को नियंत्रित कर सकता है। न्यूनतम विशेषाधिकार के लिए, सॉकेट के सामनेtecnativa/docker-socket-proxyजैसा केवल-पढ़ने वाला API प्रॉक्सी रखें और 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 खोलें। अन्य प्लेटफ़ॉर्म Releases पृष्ठ पर।
| कमांड | यह क्या करता है |
|---|---|
graph-go demo | रिपॉज़िटरी से सीडेड Docker Compose डेमो स्टैक बूट करता है और उसका आउटपुट फ़ोरग्राउंड में स्ट्रीम करता है। |
graph-go serve | ऑटो-डिस्कवरी और लाइव अपडेट के साथ HTTP सर्वर शुरू करता है (डिफ़ॉल्ट - बिना किसी आर्ग्युमेंट के चलाने के समान)। पहली डिस्कवरी पूरी होने के बाद यह stderr पर प्रत्येक एडाप्टर के लिए एक ✓/✗ पंक्ति प्रिंट करता है, जिसमें यह बताया जाता है कि उसे क्या मिला या वह क्यों विफल रहा (--log-format json के साथ छोड़ दिया जाता है)। |
graph-go scan | डिस्कवरी एक बार चलाता है और ग्राफ़ को stdout पर आउटपुट करता है। jq या CI जाँचों में पाइप करने के लिए --format json (डिफ़ॉल्ट); आरेखों के लिए mermaid, markdown (फ़ेंस्ड ब्लॉक में Mermaid, GitHub पर रेंडर होता है) या dot (Graphviz)। graph-go export इसका उपनाम है। |
graph-go validate | कॉन्फ़िग फ़ाइल की जाँच करता है और यदि वह अमान्य है तो गैर-शून्य के साथ बाहर निकलता है। हर अनुपस्थित फ़ील्ड, अज्ञात कनेक्शन प्रकार, और अज्ञात कुंजी की रिपोर्ट करता है (जिसे serve चुपचाप अनदेखा करता है)। कोई सर्वर शुरू नहीं होता। |
graph-go mcp | Model Context Protocol (stdio) के माध्यम से AI एजेंट्स को टोपोलॉजी प्रदान करता है। देखें AI एजेंट्स के साथ उपयोग (MCP)। |
graph-go version | संस्करण, कमिट, और बिल्ड तिथि प्रिंट करता है। |
graph-go --health-check | स्थानीय /health को हिट करता है और 0/1 के साथ बाहर निकलता है। कंटेनर HEALTHCHECK द्वारा उपयोग किया जाता है; इंटरैक्टिव उपयोग के लिए नहीं। |
ग्लोबल फ़्लैग (हर सबकमांड पर लागू): --config, --log-level, --log-format। पूरी प्रति-कमांड सतह के लिए graph-go <command> --help देखें।
सामान्य प्रवाह: