
Deklaratives KVM/QEMU VM-Orchestrierungstool, das YAML-Compose-Dateien verwendet. Verwaltet Multi-VM-Stacks mit cloud-init, SSH, PCI-Durchleitung und Image-Verifikation ohne libvirt oder XML.
Docker Compose für KVM. Definiere Multi-VM-Stacks in einer einzigen YAML-Datei. Kein libvirt, kein XML, keine verteilte Control Plane.
Website und Dokumentation: https://zeroecco.github.io/holos/
Das Primitiv ist eine VM, kein Container. Jede Workload-Instanz erhält ihre eigene Kernel-Grenze, ein qcow2-Overlay, ein cloud-init-Seed und generierten SSH-Zugriff.
Führe VMs auf einem Linux-Host mit /dev/kvm, QEMU und einem cloud-init-Seed-Builder aus.
Siehe Host-Anforderungen. macOS-Builds unterstützen das Erstellen,
den Download von Images und die Validierung; sie können keine KVM-VMs ausführen.
Vorkompilierte Binärdateien sind an jedes GitHub-Release angehängt:
Dieses Beispiel installiert den Linux-x86-64-Build. Es verwendet curl, tar,
sha256sum und die GitHub CLI (gh) zur Herkunftsverifizierung. Wähle für andere
Plattformen das passende Archiv auf der Release-Seite.
(
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
)
Release-Seiten enthalten SHA-256-Prüfsummen und GitHub-Artefakt-Attestierungen für signierte Provenienz. Verifizieren Sie beides, bevor Sie Binärdateien auf Produktionshosts installieren.
Oder bauen Sie aus dem Quellcode, wenn Sie über einen Checkout dieses Repositorys mit installiertem Go 1.26 verfügen:
go build -o bin/holos ./cmd/holos
export PATH="$PWD/bin:$PATH"
holos doctor
Verwenden Sie einen festen Namen, damit jeder der folgenden Befehle wie geschrieben funktioniert:
holos run --name try-holos alpine
holos exec -w 5m try-holos
Sie befinden sich jetzt im Gast. Führen Sie cat /etc/os-release aus und dann exit, um zum Host zurückzukehren. Vom Host aus:
holos stop try-holos # keep the guest disk
holos start try-holos
holos exec try-holos
Beende den Gast erneut, und entferne dann die Einweg-VM:
holos down try-holos # deletes its guest disk
Erstellen Sie ein leeres Verzeichnis und speichern Sie dies als 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
Aus diesem Verzeichnis:
holos up
holos exec -w 5m web -- sudo cloud-init status --wait
curl --fail localhost:8080
Erwarte hello from holos. Das Warten ist wichtig: up startet die VM, aber nginx wird während des ersten Boots installiert. Wenn die Bereitstellung fehlschlägt, lies holos logs web.
Innerhalb eines Projektverzeichnisses:
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
Verwende einen Instanznamen wie web-0, wenn ein Dienst mehrere Replikate hat.
Änderungen, die eine VM ersetzen oder entfernen, erfordern holos up --recreate; prüfe
zuerst die Vorschau, da das Ersetzen die Root-Disk dieser VM löscht. Benannte Volumes
bleiben erhalten. Siehe die Update-Anleitung,
bevor du Projekte aktualisierst, die von einer älteren Version erstellt wurden.
Wenn du mit diesem Wegwerf-Stack fertig bist:
holos down hello
stop behält die Instanz-Disks bei. down löscht sie; benannte Volumes bleiben erhalten, bis sie explizit entfernt werden. Siehe die CLI-Anleitung für Snapshots, Volumes, Image-Locks und systemd-Einrichtung.
exec, systemd-Installation, virsh-Import und doctor.holos.yaml./dev/kvmqemu-system-x86_64qemu-imgcloud-localds, genisoimage, mkisofs oder xorrisossh für holos exec und HealthchecksFühren Sie holos doctor aus, um den Host zu prüfen.
Prüfen Sie id -nG und ls -l /dev/kvm. Auf Hosts, auf denen das Gerät zur Gruppe kvm gehört, fügen Sie Ihren Benutzer mit sudo usermod -aG kvm "$USER" hinzu und melden Sie sich anschließend ab und erneut an. Bestehende Shells behalten ihre alte Gruppenzugehörigkeit. Führen Sie holos doctor erneut aus der neuen Sitzung aus.
kex_exchange_identification: read: Connection reset by peer bedeutet in der Regel, dass cloud-init noch Host-Keys neu generiert und sshd neu startet. holos exec wartet standardmäßig bis zu 60s, aber sehr langsame erste Boots können einen weiteren Versuch oder holos exec -w 5m <project> erfordern.
Login incorrectDie serielle Konsole versucht möglicherweise einen Autologin, bevor cloud-init den Benutzer erstellt. Warten Sie im Konsolen-Log auf cloud-init ... finished und verwenden Sie dann holos exec. Cloud-Images werden im Allgemeinen ohne Konsolen-Passwort ausgeliefert, und holos fügt keines hinzu.
up schlägt auf macOS fehlKVM ist eine Funktion des Linux-Kernels. macOS-Binaries sind nützlich für das Verfassen und für Offline-Befehle, aber holos up und holos run müssen auf einem Linux-KVM-Host ausgeführt werden.
holos ist nicht Kubernetes. Es versucht nicht, Multi-Host-Clustering, Live-Migration, Service Meshes, Overlay-Netzwerke, Scheduler, CRDs oder Control-Plane-Quorum zu lösen.
Das Ziel ist es, KVM für Single-Host-Stacks nutzbar zu machen, ohne die Betriebsform von Kubernetes zu übernehmen.
Lizenziert unter der Apache License, Version 2.0. Siehe NOTICE für die Namensnennung.
Entdecken Sie die meistgenutzten Tools unserer Community.
Noch keine Beliebtheitsdaten.