用于 KVM 的 Docker compose。在一个 YAML 文件中定义多虚拟机栈。无需 libvirt,无需 XML,无需分布式控制平面。
网站与文档:https://zeroecco.github.io/holos/
其基本单元是虚拟机,而非容器。每个工作负载实例都拥有自己的 内核边界、qcow2 覆盖层、cloud-init 种子以及生成的 SSH 访问。
在具备 /dev/kvm、QEMU 和 cloud-init 种子构建器的 Linux 主机上运行虚拟机。
参见主机要求。macOS 构建支持编写、
镜像下载和验证;但无法运行 KVM 虚拟机。
预构建的二进制文件附在每个 GitHub release 中:
此示例安装 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
你现在处于 guest 中。运行 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 这样的实例名称。
替换或移除虚拟机的变更需要执行 holos up --recreate;请先检查
预览,因为替换操作会删除该虚拟机的根磁盘。命名卷会保留。
在更新由旧版本创建的项目之前,请参阅更新指南。
使用完这个一次性堆栈后:
holos down hello
stop 会保留实例磁盘。down 会删除它们;命名卷会保留,直到被显式移除。有关快照、卷、镜像锁和 systemd 设置,请参阅 CLI 指南。
exec、systemd 安装、virsh 导入和 doctor。holos.yaml 的编辑器补全和校验。/dev/kvm 的 Linuxqemu-system-x86_64qemu-imgcloud-localds、genisoimage、mkisofs 或 xorriso 之一holos exec 和健康检查的 ssh运行 holos doctor 检查主机。
检查 id -nG 和 ls -l /dev/kvm。在设备属于 kvm 组的主机上,使用 sudo usermod -aG kvm "$USER" 添加你的用户,然后注销并重新连接。现有 shell 会保留旧的组成员身份。从新会话再次运行 holos doctor。
kex_exchange_identification: read: Connection reset by peer 通常意味着 cloud-init 仍在重新生成主机密钥并重启 sshd。holos exec 默认最多等待 60 秒,但非常慢的首次启动可能需要再次重试或使用 holos exec -w 5m <project>。
Login incorrect串口控制台可能会在 cloud-init 创建用户之前尝试自动登录。等待控制台日志中出现 cloud-init ... finished,然后使用 holos exec。云镜像通常不附带控制台密码,holos 也不会添加密码。
up 失败KVM 是 Linux 内核特性。macOS 二进制文件可用于编写和离线命令,但 holos up 和 holos run 必须在 Linux KVM 主机上执行。
holos 不是 Kubernetes。它不试图解决多主机集群、实时迁移、服务网格、覆盖网络、调度器、CRD 或控制平面法定人数。
目标是让 KVM 在单主机堆栈中可用,而不引入 Kubernetes 的运维形态。
根据 Apache License, Version 2.0 授权。有关署名信息,请参阅 NOTICE。