zeroecco/holosOutil déclaratif d'orchestration de VM KVM/QEMU utilisant des fichiers de composition YAML. Gère des piles multi-VM avec cloud-init, SSH, PCI passthrough et vérification d'image sans libvirt ni XML.
Docker compose pour KVM. Définissez des piles multi-VM dans un seul fichier YAML. Pas de libvirt, pas de XML, pas de plan de contrôle distribué.
Site web et documentation : https://zeroecco.github.io/holos/
La primitive est une VM, pas un conteneur. Chaque instance de charge de travail obtient sa propre frontière de noyau, son overlay qcow2, son seed cloud-init et un accès SSH généré.
Nécessite Linux +
/dev/kvm. Les builds macOS exécutent des commandes hors ligne commevalidate,import,imagesetpull, maisupetrunnécessitent un hôte KVM.
Une VM jetable, sans fichier compose :
holos run alpine
holos exec <printed-project-name>
holos down <printed-project-name>
Une pile à service unique que vous pouvez curl. Enregistrez sous 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
C'est une vraie VM qui démarre une image cloud, installe un paquet, écrit une configuration et transfère un port hôte.
Les binaires pré-compilés sont joints à chaque version GitHub :
TAG=v0.6.1
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
Les pages de version incluent des sommes de contrôle SHA-256 et des attestations d'artefact GitHub pour une provenance signée. Vérifiez les deux avant d'installer des binaires sur des hôtes de production.
Ou compilez depuis les sources :
go build -o bin/holos ./cmd/holos
go test ./...
bin/holos doctor
holos up [-f holos.yaml] [--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] 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
exec, installation systemd, import virsh et doctor.holos.yaml.Commencez avec le petit exemple nginx :
holos up -f examples/alpine-nginx/holos.yaml
curl localhost:8080
holos down alpine-nginx
Le répertoire exemples inclut également le provisionnement Dockerfile, le passthrough GPU et une pile multi-service qui montre depends_on, une configuration générée et des réplicas.
/dev/kvmqemu-system-x86_64qemu-imgcloud-localds, genisoimage, mkisofs ou xorrisossh pour holos exec et les vérifications de santéExécutez holos doctor pour vérifier l'hôte.
kex_exchange_identification: read: Connection reset by peer signifie généralement que cloud-init est encore en train de régénérer les clés d'hôte et de redémarrer sshd. holos exec attend jusqu'à 60s par défaut, mais les premiers démarrages très lents peuvent nécessiter une nouvelle tentative ou holos exec -w 5m <project>.
Login incorrectLa console série peut tenter une connexion automatique avant que cloud-init ne crée l'utilisateur. Attendez cloud-init ... finished dans le journal de la console, puis utilisez holos exec. Les images cloud n'ont généralement pas de mot de passe console et holos n'en ajoute pas.
up échoue sur macOSKVM est une fonctionnalité du noyau Linux. Les binaires macOS sont utiles pour la rédaction et les commandes hors ligne, mais holos up et holos run doivent être exécutés sur un hôte Linux KVM.
holos n'est pas Kubernetes. Il n'essaie pas de résoudre le clustering multi-hôte, la migration à chaud, les maillages de services, les réseaux overlay, les ordonnanceurs, les CRD ou le quorum du plan de contrôle.
L'objectif est de rendre KVM utilisable pour des piles mono-hôte sans importer la forme opérationnelle de Kubernetes.
Sous licence Apache License, Version 2.0. Voir NOTICE pour les attributions.