
أداة تنسيق (orchestration) افتراضية KVM/QEMU تعريفية (Declarative) تستخدم ملفات compose بصيغة YAML. تدير مجموعات متعددة من الأجهزة الافتراضية (multi-VM stacks) مع cloud-init وSSH وتمرير PCI (PCI passthrough) والتحقق من الصور (image verification) دون الحاجة إلى libvirt أو XML.
Docker compose لـ KVM. عرّف حزمًا متعددة الأجهزة الافتراضية في ملف YAML واحد. بلا libvirt، بلا XML، بلا لوحة تحكم موزعة.
الموقع والتوثيق: https://zeroecco.github.io/holos/
الوحدة الأساسية هي الجهاز الافتراضي، وليس الحاوية. كل نسخة من عبء العمل تحصل على حدود نواة خاصة بها، وطبقة qcow2 علوية، وبذرة cloud-init، ووصول SSH مُولَّد.
شغّل الأجهزة الافتراضية على مضيف Linux يتوفر فيه /dev/kvm وQEMU وأداة بناء بذرة cloud-init.
راجع متطلبات المضيف. تدعم إصدارات macOS التأليف،
وتنزيل الصور، والتحقق؛ لكنها لا تستطيع تشغيل أجهزة KVM الافتراضية.
تُرفَق ملفات ثنائية جاهزة مع كل إصدار على GitHub:
يثبّت هذا المثال إصدار Linux x86-64. ويستخدم curl وtar
وsha256sum وأداة GitHub CLI (gh) للتحقق من المصدر. بالنسبة إلى
المنصات الأخرى، اختر الأرشيف المطابق في صفحة الإصدار.
(
set -e
TAG=v0.7.1
ASSET=holos_${TAG#v}_Linux_x86_64.tar.gz
BASE=https://github.com/zeroecco/holos/releases/download/$TAG
curl -fLO $BASE/$ASSET
curl -fLO $BASE/checksums.txt
grep " $ASSET$" checksums.txt | sha256sum -c -
gh attestation verify $ASSET --repo zeroecco/holos
sudo tar -xz -C /usr/local/bin -f $ASSET holos
holos version
holos doctor
)
تتضمن صفحات الإصدارات مجاميع تحقق SHA-256 وإثباتات أصناف GitHub الخاصة بمصدر موثّق. تحقق من كليهما قبل تثبيت الملفات التنفيذية على مضيفات الإنتاج.
أو، من نسخة مستخرجة من هذا المستودع مع تثبيت Go 1.26، ابنِ من المصدر:
go build -o bin/holos ./cmd/holos
export PATH="$PWD/bin:$PATH"
holos doctor
استخدم اسمًا ثابتًا حتى تعمل كل الأوامر أدناه كما هي مكتوبة:
holos run --name try-holos alpine
holos exec -w 5m try-holos
أنت الآن داخل الضيف. نفّذ cat /etc/os-release، ثم exit للعودة إلى
المضيف. من المضيف:
holos stop try-holos # keep the guest disk
holos start try-holos
holos exec try-holos
اخرج من الضيف مرة أخرى، ثم أزل الجهاز الظاهري القابل للتخلص منه:
holos down try-holos # deletes its guest disk
أنشئ دليلاً فارغاً واحفظ هذا باسم holos.yaml:
name: hello
services:
web:
image: ubuntu:noble
ports:
- "8080:80"
cloud_init:
packages: [nginx]
write_files:
- path: /var/www/html/index.html
content: "hello from holos\n"
runcmd:
- systemctl restart nginx
من ذلك الدليل:
holos up
holos exec -w 5m web -- sudo cloud-init status --wait
curl --fail localhost:8080
توقّع hello from holos. الانتظار مهم: up يشغّل الجهاز الافتراضي، لكن nginx يُثبَّت أثناء الإقلاع الأول. إذا فشل التزويد، اقرأ holos logs web.
داخل دليل مشروع:
holos exec web # guest shell; exit returns to the host
holos logs web # boot and provisioning logs
holos stop web # keep its disk
holos start web
holos up --dry-run # preview changes after editing holos.yaml
holos help exec # syntax and options
استخدم اسم نسخة مثل web-0 عندما تكون للخدمة عدة نسخ متماثلة.
التغييرات التي تستبدل جهازًا افتراضيًا (VM) أو تزيله تتطلب holos up --recreate؛ تحقق من
المعاينة أولًا لأن الاستبدال يحذف القرص الجذري لذلك الجهاز الافتراضي. تبقى وحدات التخزين
المسمّاة. راجع دليل التحديث
قبل تحديث المشاريع التي أنشأتها إصدارات أقدم.
عند الانتهاء من هذه الحزمة القابلة للتخلص:
holos down hello
stop يحافظ على أقراص النسخة. down يحذفها؛ تبقى الأحجام المسماة حتى
تُزال صراحةً. راجع دليل CLI للقطات والأحجام
وأقفال الصور وإعداد systemd.
exec، تثبيت systemd، استيراد virsh،
وdoctor.holos.yaml./dev/kvmqemu-system-x86_64qemu-imgcloud-localds أو genisoimage أو mkisofs أو xorrisossh لـ holos exec وفحوصات السلامةشغّل holos doctor للتحقق من المضيف.
تحقق من id -nG وls -l /dev/kvm. على المضيفين حيث ينتمي الجهاز إلى مجموعة
kvm، أضف مستخدمك باستخدام sudo usermod -aG kvm "$USER"، ثم سجّل الخروج
وأعد الاتصال. تحتفظ الأصداف الموجودة بعضويتها القديمة في المجموعة. شغّل
holos doctor مرة أخرى من الجلسة الجديدة.
kex_exchange_identification: read: Connection reset by peer يعني عادةً
أن cloud-init لا يزال يعيد إنشاء مفاتيح المضيف ويعيد تشغيل sshd. ينتظر holos exec
حتى 60 ثانية افتراضيًا، لكن عمليات الإقلاع الأولى البطيئة جدًا قد تحتاج إلى محاولة أخرى أو
holos exec -w 5m <project>.
Login incorrectقد تحاول وحدة التحكم التسلسلية تسجيل الدخول التلقائي قبل أن ينشئ cloud-init المستخدم.
انتظر ظهور cloud-init ... finished في سجل وحدة التحكم، ثم استخدم holos exec.
عادةً لا تأتي صور السحابة بكلمة مرور لوحدة التحكم، ولا يضيف holos
واحدة.
up fails on macOSKVM ميزة في نواة Linux. ملفات macOS الثنائية مفيدة للتأليف والأوامر
غير المتصلة، لكن holos up وholos run يجب أن يُنفَّذا على مضيف Linux KVM.
holos ليس Kubernetes. لا يحاول حل التجميع متعدد المضيفين، أو الترحيل الحي، أو شبكات الخدمات، أو الشبكات المتراكبة، أو المجدولات، أو CRDs، أو نصاب مستوى التحكم.
الهدف هو جعل KVM عمليًا لحزم مضيف واحد دون استيراد الشكل التشغيلي لـ Kubernetes.
مرخّص بموجب Apache License, Version 2.0. راجع
NOTICE للإسناد.