अपडेट पर वापस जाएँ
New releaseAug 14, 2026

holos v0.6.2

YAML कंपोज़ फ़ाइलों का उपयोग करने वाला घोषणात्मक KVM/QEMU VM ऑर्केस्ट्रेशन टूल। बिना libvirt या XML के cloud-init, SSH, PCI पासथ्रू और इमेज सत्यापन के साथ मल्टी-VM स्टैक का प्रबंधन करता है।

साझा करें
holos

KVM के लिए Docker compose। एक YAML फ़ाइल में मल्टी-VM स्टैक परिभाषित करें। न libvirt, न XML, न वितरित कंट्रोल प्लेन।

वेबसाइट और दस्तावेज़: https://zeroecco.github.io/holos/

मूल इकाई एक VM है, कंटेनर नहीं। प्रत्येक वर्कलोड इंस्टेंस को अपना कर्नेल बाउंड्री, qcow2 ओवरले, cloud-init सीड, और जनरेट किया गया SSH एक्सेस मिलता है।

त्वरित शुरुआत

Linux + /dev/kvm आवश्यक है। macOS बिल्ड्स ऑफ़लाइन कमांड जैसे validate, import, images, और pull चलाते हैं, लेकिन up और run के लिए KVM होस्ट आवश्यक है।

एक डिस्पोज़ेबल VM, कोई compose फ़ाइल नहीं:

holos run alpine
holos exec <printed-project-name>
holos down <printed-project-name>

curl से उपयोग किया जा सकने वाला एकल-सेवा स्टैक। इसे 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
curl localhost:8080
holos down hello

यह एक वास्तविक VM है जो क्लाउड इमेज बूट कर रहा है, एक पैकेज इंस्टॉल कर रहा है, कॉन्फ़िग लिख रहा है, और एक होस्ट पोर्ट फ़ॉरवर्ड कर रहा है।

दैनिक उपयोग

एक प्रोजेक्ट डायरेक्टरी के अंदर:

holos exec web       # open a guest shell
holos logs           # read project boot logs
holos stop web       # keep its disk
holos start web
holos up --dry-run   # preview configuration changes
holos help exec      # command syntax and options

किसी सेवा के कई रेप्लिका होने पर web-0 जैसा इंस्टेंस नाम इस्तेमाल करें।

इंस्टॉल करें

हर GitHub रिलीज़ के साथ प्री-बिल्ट बाइनरीज़ संलग्न हैं:

TAG=v0.6.3
ASSET=holos_${TAG#v}_Linux_x86_64.tar.gz
BASE=https://github.com/zeroecco/holos/releases/download/$TAG
curl -LO $BASE/$ASSET
curl -LO $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 build -o bin/holos ./cmd/holos
go test ./...
bin/holos doctor

CLI

holos up [-f holos.yaml] [--dry-run] [--recreate] [--strict] [--locked] [--lockfile path] [--lock-timeout 5m|--no-wait]
                                     start all services
holos run [flags] <image> [-- cmd...] launch a one-off VM
holos down <project>                 stop and remove a project
holos ps [-f holos.yaml]             list running projects
holos start [-f holos.yaml] [svc]    start a stopped service or all services
holos stop [-f holos.yaml] [svc]     stop a service or all services
holos console <project> [<inst>]     attach serial console
holos exec <project> [<inst>] [-- cmd...]
                                     SSH into an instance
holos logs <project> [<svc|inst>]    show console logs
holos inspect [-f holos.yaml] [project|instance]
                                     inspect state as JSON
holos validate [-f holos.yaml] [--strict]
                                     validate compose file (--capacity/--network)
holos pull <image>                   pull a cloud image
holos verify <image>|--all           verify cached image checksums
holos images                         list available images
holos images lock -f holos.yaml [-o holos.images.lock]
                                     write project image lockfile
holos snapshots {create|list|rm|restore|export} ... manage root snapshots
holos volumes [-f holos.yaml] [--json]
                                     list named volumes
holos volumes rm <project> <volume>  remove a detached named volume
holos volumes export <project> <volume> <path>
                                     export a detached named volume
holos volumes snapshot <project> <volume> <snapshot>
                                     snapshot a detached named volume
holos volumes snapshots <project> <volume>
                                     list volume snapshots
holos volumes snapshot-rm <project> <volume> <snapshot>
                                     remove a volume snapshot
holos volumes snapshot-restore <project> <volume> <snapshot>
                                     restore a volume snapshot
holos volumes snapshot-export <project> <volume> <snapshot> <path>
                                     export a volume snapshot
holos volumes resize [--shrink] <project> <volume> <size>
                                     resize a detached named volume
holos devices [--gpu]                list PCI devices and IOMMU groups
holos completion <bash|zsh|fish>      print shell completion script
holos doctor [--json]                check host dependencies
holos install [-f holos.yaml] [--system] [--enable]
                                     install a systemd unit
holos uninstall [-f holos.yaml] [--system]
                                     remove the systemd unit
holos import [vm...] [--all] [--xml file] [--connect uri] [-o file]
                                     convert virsh VMs into holos.yaml

दस्तावेज़

  • वेबसाइट: लैंडिंग पेज और रेंडर किए गए दस्तावेज़।
  • CLI गाइड: तदर्थ VM, exec, systemd इंस्टॉल, virsh इम्पोर्ट, और doctor।
  • Compose फ़ाइल: सेवाएँ, वॉल्यूम, हेल्थचेक, नेटवर्किंग, PCI पासथ्रू, Dockerfile प्रोविज़निंग, और डिफ़ॉल्ट।
  • JSON Schema: holos.yaml के लिए एडिटर कम्प्लीशन और वैलिडेशन।
  • उदाहरण: README-शैली की व्याख्याओं के साथ रन करने योग्य और टेम्पलेट स्टैक।
  • अनुपलब्ध सुविधाएँ: प्राथमिकता वाले अंतराल जो holos के सिंगल-होस्ट KVM compose लक्ष्य में फ़िट होते हैं।
  • विकास: बिल्ड, टेस्ट, होस्ट आवश्यकताएँ, और रिलीज़ प्रक्रिया।
  • सुरक्षा नीति: समर्थित संस्करण और निजी रिपोर्टिंग।
  • खतरा मॉडल / हार्डनिंग: इमेज सत्यापन, स्टेट अनुमतियाँ, लॉक, और परिचालन मार्गदर्शन।
  • योगदान: बिल्ड, टेस्ट, स्टाइल, और PR परंपराएँ।

उदाहरण

छोटे nginx उदाहरण से शुरू करें:

holos up -f examples/alpine-nginx/holos.yaml
curl localhost:8080
holos down alpine-nginx

The examples directory में Dockerfile provisioning, GPU passthrough, और एक multi-service stack भी शामिल है जो depends_on, generated config, और replicas दिखाता है।

Host Requirements

  • Linux with /dev/kvm
  • qemu-system-x86_64
  • qemu-img
  • cloud-localds, genisoimage, mkisofs, या xorriso में से एक
  • UEFI या PCI passthrough के लिए OVMF / edk2-ovmf firmware
  • holos exec और healthchecks के लिए ssh

Host की जाँच करने के लिए holos doctor चलाएँ।

Troubleshooting

Permission denied opening /dev/kvm

id -nG और ls -l /dev/kvm जाँचें। उन hosts पर जहाँ device kvm group का है, अपने user को sudo usermod -aG kvm "$USER" से जोड़ें, फिर log out करके दोबारा connect करें। मौजूदा shells अपनी पुरानी group membership बनाए रखते हैं। नए session से holos doctor फिर से चलाएँ।

SSH resets on first boot

और पढ़ें

श्रेणियाँ

क्लाउड इन्फ्रास्ट्रक्चर सुरक्षासामान्य उपयोगिताएँस्क्रिप्टिंग और स्वचालनसुरक्षा वर्चुअलाइजेशनDevSecOpsहार्डवेयर सुरक्षा