الحد الأدنى من المتطلبات

يتوفر Kudashai بشكلين. Kudashai Web هو ملف تنفيذي واحد للخادم (متوفر أيضًا كمخطط Helm) يتضمن واجهة الويب، وتفتحه من المتصفح. أما Kudashai Desktop فيغلّف المحرك نفسه في نافذة أصلية لأنظمة macOS وWindows وLinux، ويضيف ميزات خاصة بسطح المكتب مثل إعادة توجيه المنافذ (port forwarding) والتحديث التلقائي. يتصل كلاهما بعناقيدك مباشرة، لذا يجب أن يتمكن الجهاز الذي يشغّل Kudashai من الوصول إلى كل خادم Kubernetes API تريد إدارته.

Kudashai Web

مضيف الخادم

	الحد الأدنى	الموصى به
المعالج	1 vCPU	2 vCPU أو أكثر
الذاكرة	1 غيغابايت متاحة لـ Kudashai	2 غيغابايت أو أكثر، مع زيادة الذاكرة للعناقيد الكبيرة أو المتعددة
القرص	500 ميغابايت حرة للملف التنفيذي وقاعدة البيانات المحلية وملفات kubeconfig	تخزين SSD
نظام التشغيل	Linux (amd64، arm64، i386)، macOS (Intel، Apple Silicon)، Windows (amd64، arm64، i386)، FreeBSD	Linux amd64 للخوادم

يزداد استهلاك الذاكرة مع عدد كائنات Kubernetes التي يراقبها Kudashai. فلكل عنقود تفتحه، يحتفظ Kudashai بنسخة في الذاكرة من كل نوع مورد تعرضه (Pods وDeployments وEvents وغيرها) لكي تتحدث الواجهة فورًا. العنقود الذي يحتوي عشرات الآلاف من Pods يحتاج وحده إلى عدة مئات من الميغابايت. حدّد حجم المضيف وفق أكبر عنقود تديره، لا وفق عدد العناقيد.

يطلب مخطط Helm افتراضيًا 100m من المعالج و256Mi من الذاكرة كحد أقصى. ارفع قيمة resources.limits.memory في ملف values قبل توجيه Kudashai إلى عناقيد بحجم الإنتاج.

عناقيد Kubernetes

• Kubernetes 1.23 أو أحدث. يقرأ Kudashai واجهات API المستقرة apps/v1 وbatch/v1 وautoscaling/v2 وpolicy/v1 وnetworking.k8s.io/v1 وdiscovery.k8s.io/v1؛ وأحدثها autoscaling/v2 التي أصبحت مستقرة في الإصدار 1.23.
• ملف kubeconfig أو رمز Bearer أو شهادة عميل تملك صلاحيتي list وwatch على الموارد التي تريد عرضها. صلاحية القراءة على مستوى العنقود تعطي الصورة الأكمل؛ أما بيانات الاعتماد المحصورة في namespace فتعمل لكنها تخفي الموارد على مستوى العنقود مثل Nodes وPersistent Volumes.
• اختياري: metrics-server داخل العنقود لعرض استهلاك المعالج والذاكرة. بدونه يعمل Kudashai لكنه لا يعرض أرقام الاستهلاك الحية.
• إمكانية الوصول: يجب أن يصل مضيف Kudashai إلى خادم API لكل عنقود (المنفذ TCP 6443 في معظم التوزيعات). يمكن الوصول إلى العناقيد خلف مضيف وسيط (bastion) عبر نفق SSH المدمج في Kudashai، وهذا يتطلب وصول SSH (المنفذ TCP 22) إلى المضيف الوسيط.

قاعدة البيانات (وضع Platform فقط)

تخزّن أوضاع Standalone كل شيء في ملف SQLite محلي ضمن ~/.kudashai ولا تحتاج إلى خادم قاعدة بيانات. أما وضع Platform، الذي يفعّل تسجيل الدخول متعدد المستخدمين والتحكم بالوصول المبني على الأدوار، فيحتاج إلى:

• PostgreSQL 13 أو أحدث (يستخدم المخطط gen_random_uuid() وJSONB). تستخدم ملفات النشر المرفقة PostgreSQL 16.
• قاعدة بيانات ودور (role) يملكها. ينشئ Kudashai جداوله ويرحّلها بنفسه.
• وصول شبكي من مضيف Kudashai إلى PostgreSQL (المنفذ TCP 5432 افتراضيًا).

المتصفح

أي إصدار حديث من Chrome أو Edge أو Firefox أو Safari. تستهدف الواجهة ES2020 وتبث التحديثات الحية عبر Server-Sent Events، لذا لا تُدعم المتصفحات الصادرة قبل عام 2020.

لأي وصول غير http://localhost، قدّم Kudashai عبر HTTPS (--certFile و--keyFile، أو وكيل عكسي ينهي TLS). عبر HTTP/1.1 العادي يفتح المتصفح ست وصلات كحد أقصى لكل مضيف، وكل عرض مورد مفتوح يحتفظ ببث حي واحد، فتتوقف العروض عن التحديث عند بلوغ هذا الحد. يفعّل HTTPS بروتوكول HTTP/2 الذي يزيل هذا الحد.

الشبكة

الاتجاه	الوجهة	الغرض
وارد	TCP 7080 (افتراضي؛ يُغيَّر بـ --listen)	وصول المستخدمين إلى الواجهة وAPI
صادر	خوادم Kubernetes API	إدارة العناقيد
صادر	PostgreSQL (وضع Platform)	قاعدة البيانات المشتركة
صادر	نقاط نهاية مزوّد الذكاء الاصطناعي (اختياري)	ميزات الذكاء الاصطناعي، فقط عند ضبط مزوّد. المزوّدون المستضافون ذاتيًا مدعومون، لذا لا يلزم اتصال بالإنترنت
صادر	مضيفو SSH الوسيطون (اختياري)	العناقيد عبر النفق

Kudashai Desktop

يشغّل Kudashai Desktop المحرك نفسه الموجود في Kudashai Web داخل التطبيق، وتُعرض الواجهة بواسطة عارض الويب المدمج في نظام التشغيل (WebKit في macOS، وWebView2 في Windows، وWebKitGTK في Linux). كل ما ورد في قسمي عناقيد Kubernetes والشبكة أعلاه ينطبق على تطبيق سطح المكتب أيضًا.

نظام التشغيل

المنصة	المتطلب
macOS	macOS 10.13 (High Sierra) أو أحدث. تتوفر إصدارات لمعالجات Intel وApple Silicon
Windows	Windows 10 أو 11، 64 بت (amd64 أو arm64)، مع Microsoft Edge WebView2 Runtime. يتضمنه Windows 11 وWindows 10 المحدّث؛ وإلا يطلب التطبيق تنزيله عند التشغيل الأول
Linux	توزيعة 64 بت (amd64 أو arm64) مع GTK 3 وlibwebkit2gtk-4.0، مثل Ubuntu 22.04 أو Debian 12

العتاد

	الحد الأدنى	الموصى به
المعالج	ثنائي النواة 64 بت	رباعي النواة
الذاكرة	4 غيغابايت من ذاكرة النظام، مع نحو 1 غيغابايت حرة لـ Kudashai	8 غيغابايت أو أكثر عند إدارة عناقيد كبيرة
القرص	500 ميغابايت حرة في المجلد الرئيسي لقاعدة البيانات المحلية وملفات kubeconfig والتحديثات المنزّلة	SSD

تنطبق قاعدة التحجيم نفسها المطبّقة على الخادم: تتحدد الذاكرة بحجم العناقيد التي تفتحها، يضاف إليها عارض الويب الذي يستهلك ما يعادل تبويب متصفح واحد تقريبًا.

الترخيص والشبكة

• مفتاح ترخيص Kudashai Desktop من AwanIO Enterprise Portal. يُدخل المفتاح داخل التطبيق من Settings > License.
• اتصال HTTPS صادر (TCP 443) إلى enterprise-portal.awan.io لتفعيل الترخيص والتحقق اليومي منه وتحديث التطبيق. يبقي الترخيص المخزّن التطبيق عاملًا دون اتصال ضمن فترة السماح.
• تُحفظ البيانات المحلية في ~/.kudashai على macOS وLinux، وفي مجلد ملف تعريف المستخدم على Windows.
• اختياري: PostgreSQL 13 أو أحدث إذا حوّلت تطبيق سطح المكتب إلى قاعدة بيانات مشتركة من Settings > Database، وهو ما يجعله عميلًا لوضع Platform.

الخطوات التالية

• التثبيت — تنزيل Kudashai وتشغيله
• البدء — أوضاع التشغيل وتسجيل الدخول الأول
• إدارة المجموعات المتعددة — ربط عدة عناقيد