
Outil 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 dispose de sa propre frontière de noyau, de son overlay qcow2, de sa graine cloud-init et d'un accès SSH généré.
Exécutez des VM sur un hôte Linux avec /dev/kvm, QEMU et un constructeur de graine cloud-init.
Voir prérequis de l'hôte. Les builds macOS prennent en charge la création,
le téléchargement d'images et la validation ; ils ne peuvent pas exécuter de VM KVM.
Des binaires précompilés sont joints à chaque version GitHub :
Cet exemple installe le build Linux x86-64. Il utilise curl, tar,
sha256sum et la CLI GitHub (gh) pour la vérification de provenance. Pour d'autres
plateformes, choisissez l'archive correspondante sur la page de la version.
(
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
)
Les pages de version incluent des sommes de contrôle SHA-256 et des attestations d'artefacts GitHub pour une provenance signée. Vérifiez les deux avant d'installer des binaires sur des hôtes de production.
Ou, à partir d'une copie de ce dépôt avec Go 1.26 installé, compilez depuis les sources :
go build -o bin/holos ./cmd/holos
export PATH="$PWD/bin:$PATH"
holos doctor
Utilisez un nom fixe pour que chaque commande ci-dessous fonctionne telle qu'elle est écrite :
holos run --name try-holos alpine
holos exec -w 5m try-holos
Vous êtes maintenant dans l'invité. Exécutez cat /etc/os-release, puis exit pour revenir à l'hôte. Depuis l'hôte :
holos stop try-holos # keep the guest disk
holos start try-holos
holos exec try-holos
Quittez à nouveau l'invité, puis supprimez la VM jetable :
holos down try-holos # deletes its guest disk
Créez un répertoire vide et enregistrez ceci sous le nom 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
À partir de ce répertoire :
holos up
holos exec -w 5m web -- sudo cloud-init status --wait
curl --fail localhost:8080
Attendez-vous à hello from holos. L'attente est importante : up démarre la VM, mais nginx est installé lors du premier démarrage. Si le provisionnement échoue, consultez holos logs web.
Dans un répertoire de projet :
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
Utilisez un nom d'instance tel que web-0 lorsqu'un service possède plusieurs réplicas.
Les modifications qui remplacent ou suppriment une VM nécessitent holos up --recreate ; vérifiez d'abord
l'aperçu, car le remplacement supprime le disque racine de cette VM. Les volumes nommés
survivent. Consultez le guide de mise à jour
avant de mettre à jour des projets créés par une version antérieure.
Lorsque vous avez terminé avec cette pile jetable :
holos down hello
stop préserve les disques de l'instance. down les supprime ; les volumes nommés subsistent jusqu'à leur suppression explicite. Consultez le guide CLI pour les snapshots, les volumes, les verrous d'images et la configuration systemd.
exec, installation systemd, import virsh et doctor.holos.yaml./dev/kvmqemu-system-x86_64qemu-imgcloud-localds, genisoimage, mkisofs ou xorrisossh pour holos exec et les healthchecksExécutez holos doctor pour vérifier l'hôte.
Vérifiez id -nG et ls -l /dev/kvm. Sur les hôtes où le périphérique appartient au groupe kvm, ajoutez votre utilisateur avec sudo usermod -aG kvm "$USER", puis déconnectez-vous et reconnectez-vous. Les shells existants conservent leur ancienne appartenance de groupe. Relancez holos doctor depuis la nouvelle session.
kex_exchange_identification: read: Connection reset by peer signifie généralement que cloud-init régénère encore les clés d'hôte et redémarre sshd. holos exec attend jusqu'à 60 s 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 un autologin 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 ne fournissent 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 l'écriture et les commandes hors ligne, mais holos up et holos run doivent s'exécuter sur un hôte Linux KVM.
holos n'est pas Kubernetes. Il ne cherche pas à résoudre le clustering multi-hôtes, la migration à chaud, les service meshes, les réseaux overlay, les schedulers, les CRD ou le quorum du control plane.
L'objectif est de rendre KVM exploitable pour des stacks mono-hôte sans importer la forme opérationnelle de Kubernetes.