
holos v0.6.2
أداة تنسيق (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.
المستندات
- الموقع: الصفحة الرئيسية والمستندات المعروضة.
- دليل CLI: الأجهزة الافتراضية المؤقتة،
exec، تثبيت systemd، استيراد virsh، وdoctor. - ملف Compose: الخدمات، والأحجام، وفحوصات السلامة، والشبكات، وتمرير PCI، وتوفير Dockerfile، والإعدادات الافتراضية.
- مخطط JSON: الإكمال والتحقق في المحرر لـ
holos.yaml. - الأمثلة: حزم قابلة للتشغيل وقوالب مع شروحات بأسلوب README.
- الميزات المفقودة: الفجوات ذات الأولوية التي تناسب هدف holos في compose KVM على مضيف واحد.
- التطوير: البناء، والاختبار، ومتطلبات المضيف، و عملية الإصدار.
- سياسة الأمان: الإصدارات المدعومة والإبلاغ الخاص.
- نموذج التهديد / التقوية: التحقق من الصور، وأذونات الحالة، والأقفال، والإرشادات التشغيلية.
- المساهمة: البناء، والاختبار، والأسلوب، واصطلاحات PR.
متطلبات المضيف
- Linux مع
/dev/kvm qemu-system-x86_64qemu-img- واحد من
cloud-localdsأوgenisoimageأوmkisofsأوxorriso - برنامج OVMF / edk2-ovmf الثابت لـ UEFI أو تمرير PCI
sshلـholos execوفحوصات السلامة
شغّل holos doctor للتحقق من المضيف.
استكشاف الأخطاء وإصلاحها
Permission denied opening /dev/kvm
تحقق من id -nG وls -l /dev/kvm. على المضيفين حيث ينتمي الجهاز إلى مجموعة
kvm، أضف مستخدمك باستخدام sudo usermod -aG kvm "$USER"، ثم سجّل الخروج
وأعد الاتصال. تحتفظ الأصداف الموجودة بعضويتها القديمة في المجموعة. شغّل
holos doctor مرة أخرى من الجلسة الجديدة.
SSH resets on first boot
kex_exchange_identification: read: Connection reset by peer يعني عادةً
أن cloud-init لا يزال يعيد إنشاء مفاتيح المضيف ويعيد تشغيل sshd. ينتظر holos exec
حتى 60 ثانية افتراضيًا، لكن عمليات الإقلاع الأولى البطيئة جدًا قد تحتاج إلى محاولة أخرى أو
holos exec -w 5m <project>.
Console shows Login incorrect
قد تحاول وحدة التحكم التسلسلية تسجيل الدخول التلقائي قبل أن ينشئ cloud-init المستخدم.
انتظر ظهور cloud-init ... finished في سجل وحدة التحكم، ثم استخدم holos exec.
عادةً لا تأتي صور السحابة بكلمة مرور لوحدة التحكم، ولا يضيف holos
واحدة.
up fails on macOS
KVM ميزة في نواة Linux. ملفات macOS الثنائية مفيدة للتأليف والأوامر
غير المتصلة، لكن holos up وholos run يجب أن يُنفَّذا على مضيف Linux KVM.
أهداف غير مرجوة
holos ليس Kubernetes. لا يحاول حل التجميع متعدد المضيفين، أو الترحيل الحي، أو شبكات الخدمات، أو الشبكات المتراكبة، أو المجدولات، أو CRDs، أو نصاب مستوى التحكم.
الهدف هو جعل KVM عمليًا لحزم مضيف واحد دون استيراد الشكل التشغيلي لـ Kubernetes.
الترخيص
مرخّص بموجب Apache License, Version 2.0. راجع
NOTICE للإسناد.