التثبيت

تثبّت هذه الخطوات وحدة تحكم VM المستضافة ذاتيا المودعة على مضيف KVM واحد. لا تثبّت بنّاء الصور المستضاف ولا تؤسس نشرا مؤسسيا إنتاجيا.

1. تحقق من المصدر

افحص مراجعة OpenFactory المقصودة وراجع التغييرات المحلية قبل بناء الحاويات:

git status --short
git rev-parse HEAD

استخدم إصدارا أو التزاما مراجعا. يبني سير Compose الصور من أشجار المصدر المحلية cto-gui وcto-gui-libvirt-backend.

2. أنشئ مجلدات المضيف

sudo install -d -m 0755 /opt/openfactory/iso
sudo install -d -m 0755 /var/lib/libvirt/images/.openfactory-golden

تُوصل المسارات للقراءة فقط داخل الخلفية لمخرجات المصدر. أقراص الضيوف وملفات ISO المرفوعة تستخدم /var/lib/libvirt/images.

3. فحص مسبق لـ KVM وLibvirt

test -e /dev/kvm
test -S /var/run/libvirt/libvirt-sock
virsh -c qemu:///system list --all
docker compose version

توقف إذا فشل أي أمر. أصلح خدمة المضيف أو عضوية المجموعة أو موقع المقبس قبل تشغيل الحاويات.

4. شغّل اللوحة

نفّذ هذا من مجلد cto-gui:

docker compose -f docker-compose.self-hosted.yml up --build -d
docker compose -f docker-compose.self-hosted.yml ps

افتح http://localhost/ من المضيف. لتقييم بعيد، قيّد المنفذ 80 في جدار حماية المضيف واستخدم مسارا خاصا موثوقا إلى المضيف.

5. تحقق من وضع التشغيل

أكّد تحميل الواجهة، ثم افحص استجابة وضع الخلفية من مسار الشبكة المتاح في نشرك. يجب أن تبلّغ self_hosted: true. ينبغي أن تظهر خريطة الميزات البنايات المستضافة والمحادثات والجدولة ومستندات السياسة غير متاحة.

بعد ذلك، ارفع ISO اختبار قابلا للتصرف، أنشئ VM صغيرا، افتح وحدة تحكم VNC الخاصة به، أوقف الـ VM، واحذفه. أكّد إزالة قرص الضيف ونطاق libvirt كما هو متوقع قبل استخدام صور أكبر.

التراجع

أوقف التقييم دون حذف حجمه المسمى:

docker compose -f docker-compose.self-hosted.yml down

هذا يترك الصور المرفوعة وموارد libvirt ومجلدات المصدر وحجم cto-data سليمة. اجرد تلك الموارد قبل أي حذف. لا تستخدم down --volumes ما لم تقصد صراحة تدمير حالة اللوحة المحتفظ بها وسجلات التنظيف.