عن المشروع

# KSail يجمع KSail أدوات Kubernetes الشائعة في ملف تنفيذي واحد. أنشئ عناقيد محلية، وانشر أحمال العمل، وشغّل حزم السحابة الأصلية عبر التوزيعات والمزودين من خلال CLI، أو إضافة VS Code، أو واجهة دردشة الذكاء الاصطناعي TUI، أو خادم MCP — مع **الحاجة فقط إلى Docker أو الوصول إلى مزود سحابي**. ## التثبيت السريع ```bash # Linux / macOS (إصدار موثّق ببصمة تحقق) curl -fsSL https://github.com/devantler-tech/ksail/releases/latest/download/install.sh | sh # macOS (Homebrew) brew install --cask devantler-tech/tap/ksail ``` ## إضافات مساعد الذكاء الاصطناعي ثبّت إضافة ksail من [سوق إضافات وكيل devantler-tech](https://github.com/devantler-tech/agent-plugins) لـ [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli) أو [Claude Code](https://code.claude.com/docs/en/discover-plugins) لتسجيل خادم MCP الخاص بـ ksail تلقائيًا ومهارة خبرة ksail. **Copilot CLI:** ```bash copilot plugin marketplace add devantler-tech/agent-plugins copilot plugin install ksail@devantler-plugins ``` **Claude Code:** ```text /plugin marketplace add devantler-tech/agent-plugins /plugin install ksail@devantler-plugins ``` يتطلب وجود `ksail` على `PATH`. ## البدء السريع ```bash ksail project init --name my-app # إنشاء هيكل المشروع + إعدادات أصلية ksail cluster create # إنشاء العنقود (Docker فقط) ksail cluster connect # فتح K9s ``` ## ما الذي يجمعه KSail | الفئة | القدرات المدمجة | |--------------------------|----------------------------------------------------------------------| | توفير العناقيد | Kind، K3d، Talos، VCluster (Vind)، KWOK (kwokctl)، EKS | | تنسيق الحاويات | kubectl، Helm، Kustomize | | محركات GitOps | Flux، ArgoCD | | إدارة الأسرار | SOPS مع تشفير Age | | التحقق من البيانات | Kubeconform | | عمليات العنقود | K9s، النسخ الاحتياطي والاستعادة، تعدد المستأجرين (`ksail tenant`) | | تكامل الذكاء الاصطناعي | مساعد دردشة (Copilot SDK)، خادم MCP، إضافة VS Code | | مزودو البنية التحتية | Docker (محلي)، Kubernetes (متداخل)، Hetzner Cloud، Sidero Omni، AWS | ## المنصات المدعومة | نظام التشغيل | المعمارية | |-----------------------------------------------|--------------| | 🐧 Linux | amd64, arm64 | | 🍎 macOS | arm64 | | ⊞ Windows (الأصلي غير مُختبر؛ يُوصى بـ WSL2) | amd64, arm64 | | المزود | Vanilla | K3s | Talos | VCluster | KWOK | EKS | |------------|----------|---------|-------|----------|-------------|-----| | Docker | ✅ (Kind) | ✅ (K3d) | ✅ | ✅ (Vind) | ✅ (kwokctl) | — | | Kubernetes | ✅ | ✅ | ✅ | ✅ | ✅ | — | | Hetzner | — | — | ✅ | — | — | — | | Omni | — | — | ✅ | — | — | — | | AWS | — | — | — | — | — | 🚧 | ## المجتمع والدعم - 💬 **[مناقشات GitHub](https://github.com/devantler-tech/ksail/discussions)** — أسئلة وأفكار ومجتمع - 🐛 **[متتبع المشكلات](https://github.com/devantler-tech/ksail/issues)** — الأخطاء وطلبات الميزات - 📖 **[التوثيق](https://ksail.devantler.tech)** — أدلة، مرجع CLI، البنية - 🎓 **[الموارد](https://ksail.devantler.tech/resources/)** — عروض تقديمية، منشورات مدونة، دروس - ⭐ **[أضف نجمة للمستودع](https://github.com/devantler-tech/ksail)** — ساعد الآخرين على اكتشاف KSail ## المساهمة المساهمات مرحّب بها! راجع [CONTRIBUTING.md](CONTRIBUTING.md) لعملية التطوير ومعايير البرمجة وإرشادات طلبات السحب. ابدأ بالمشكلات الموسومة بـ [`good first issue`](https://github.com/devantler-tech/ksail/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22). ## المشاريع ذات الصلة | المشروع | الوصف | النوع | |-----------------------------------------------------------------------|-----------------------------------------------|----------| | [devantler-tech/platform](https://github.com/devantler-tech/platform) | منصة Kubernetes الشخصية للمشرف | منصة | ## الترخيص KSail مرخّص بموجب **[PolyForm Shield License 1.0.0](LICENSE)**. يمكنك استخدام KSail وتعديله وتوزيعه لأي غرض — باستثناء تقديم منتج ينافس KSail. عند إعادة التوزيع، يجب تضمين [شروط الترخيص](LICENSE) وإشعار حقوق النشر المطلوب. **ما يعنيه هذا عمليًا:** - ✅ استخدم KSail كأداة CLI في أي مشروع (مفتوح المصدر أو مملوك) - ✅ تضمين أو ربط KSail كمكتبة في برنامجك الخاص - ✅ عمل نسخة معدّلة من KSail للاستخدام الداخلي أو غير المنافس - ✅ استخدم أي ترخيص لمشروعك الخاص — لا يوجد شرط copyleft - ❌ بناء وتوزيع منتج ينافس KSail للاطلاع على النص الكامل للترخيص بما في ذلك الإشعار وتفاصيل عدم المنافسة، راجع [LICENSE](LICENSE). للأسئلة الشائعة، راجع [الأسئلة الشائعة حول الترخيص](https://ksail.devantler.tech/faq/#licensing).