
ببساطة العقد والرسوم البيانية
شاهد بنيتك التحتية. بدون إعدادات.
وجّه graph-go نحو حزمتك واحصل على خريطة تفاعلية حية لكل قاعدة بيانات وجدول وخدمة وحاوية تخزين — مع مراقبة صحة في الوقت الفعلي.
graph-go هو مُخطِّط بنية تحتية يعتمد على سطر الأوامر أولاً. يكتشف بنيتك التحتية تلقائيًا عبر الاتصال بخدمة Docker، وفحص الحاويات قيد التشغيل، واستكشاف قواعد البيانات وخدمات التخزين. تُقدَّم واجهة المستخدم من الخادم الخلفي وتعكس حالته الفعلية — دون الحاجة إلى جرد يدوي.
| القدرة | التفاصيل |
|---|---|
| الاكتشاف التلقائي | يكتشف البنية التحتية من حاويات Docker وعناقيد Kubernetes — دون الحاجة إلى جرد يدوي |
| Kubernetes | مساحات الأسماء، وDeployments، وStatefulSets، وDaemonSets، وPods، وServices — مع مراقبة فورية في الوقت الفعلي قائمة على informer |
| Docker | يصنّف الحاويات قيد التشغيل، ويستخرج بيانات الاعتماد، ويراقب أحداث Docker، ويحترم تسميات graphgo.* لتجاوز النوع/DSN/نوع العقدة/الاسم أو تجاهل حاوية |
| PostgreSQL | الجداول، وعلاقات المفاتيح الأجنبية، وطوبولوجيا المخطط |
| MongoDB | قواعد البيانات والمجموعات |
| MySQL | الجداول، وعلاقات المفاتيح الأجنبية |
| Redis | مساحات المفاتيح وتوزيع المفاتيح |
| Elasticsearch | الفهارس، وصحة العنقود، وحالة القطع (shards) |
| 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=... | تجاوز اسم العقدة المعروض في الرسم البياني والمستخدم في معرّفات العقد / السجلات |
استخدم هذه التسميات لإنقاذ الحاويات المصنَّفة خطأً، أو توجيه graph-go نحو DSN مخصص، أو إخفاء حاوية من الرسم البياني دون إزالتها.
أقلع حزمة العرض التجريبي المُهيَّأة مسبقًا باستخدام سطر الأوامر. هذه أسرع طريقة لرؤية 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.
ملف ثنائي واحد مكتفٍ ذاتيًا — واجهة المستخدم مضمّنة، لكن نقطة الدخول لا تزال هي 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. منصات أخرى على صفحة الإصدارات.
| الأمر | ما يفعله |
|---|---|
graph-go demo | يشغّل حزمة عرض Docker Compose المُهيّأة مسبقًا من المستودع ويبثّ مخرجاتها في المقدمة. |
graph-go serve | يبدأ خادم HTTP مع الاكتشاف التلقائي والتحديثات الحية (الافتراضي - نفس التشغيل بدون وسائط). بمجرد انتهاء الاكتشاف الأول يطبع سطر ✓/✗ لكل محوّل إلى stderr، مع ما وجده أو سبب فشله (يُتخطى مع --log-format json). |
graph-go scan | يشغّل الاكتشاف مرة واحدة ويُخرج الرسم البياني إلى stdout. --format json (الافتراضي) للتوجيه إلى jq أو فحوصات CI؛ mermaid أو markdown (Mermaid في كتلة محاطة بأسوار، يُعرض على GitHub) أو dot (Graphviz) للرسوم البيانية. graph-go export اسم مستعار. |
graph-go validate | يتحقق من ملف الإعدادات ويخرج بقيمة غير صفرية إذا كان غير صالح. يُبلّغ عن كل حقل مفقود، ونوع اتصال غير معروف، ومفتاح غير معروف (والذي يتجاهله serve بصمت). لا يبدأ أي خادم. |
graph-go mcp | يقدّم الطوبولوجيا لوكلاء الذكاء الاصطناعي عبر بروتوكول سياق النموذج (stdio). راجع الاستخدام مع وكلاء الذكاء الاصطناعي (MCP). |
graph-go version | يطبع الإصدار، والالتزام، وتاريخ البناء. |
graph-go --health-check | يصل إلى /health المحلي ويخرج بـ 0/1. يُستخدم بواسطة HEALTHCHECK في الحاوية؛ ليس للاستخدام التفاعلي. |
الأعلام العامة (تنطبق على كل أمر فرعي): --config، --log-level، --log-format. راجع graph-go <command> --help للسطح الكامل لكل أمر.
التدفق النموذجي:
graph-go demo لجولة محلية واقعية.graph-go serve للتشغيل مقابل بنيتك التحتية الخاصة.graph-go scan للأتمتة لمرة واحدة، أو التصدير، أو فحوصات CI — مثل graph-go export --format markdown --log-level=warn > ARCHITECTURE.md للحصول على رسم بياني يُعرض على GitHub.يمنح graph-go mcp وكلاء البرمجة (Claude Code، Cursor، أي عميل MCP) رؤية حتمية لبنيتك التحتية، حتى يتوقفوا عن التخمين من ملفات compose والبيانات الوصفية.