
Декларативный инструмент оркестрации виртуальных машин KVM/QEMU, использующий YAML-файлы компоновки. Управляет стеками из нескольких ВМ с cloud-init, SSH, пробросом PCI и проверкой образов без libvirt или XML.
Docker compose для KVM. Определяйте много-VM стеки в одном YAML-файле. Без libvirt, без XML, без распределённой панели управления.
Сайт и документация: https://zeroecco.github.io/holos/
Примитив — это VM, а не контейнер. Каждый экземпляр рабочей нагрузки получает собственную границу ядра, qcow2-оверлей, cloud-init seed и сгенерированный SSH-доступ.
Запускайте VM на Linux-хосте с /dev/kvm, QEMU и сборщиком cloud-init seed.
См. требования к хосту. Сборки для macOS поддерживают создание,
загрузку образов и валидацию; они не могут запускать KVM VM.
Готовые бинарные файлы прикреплены к каждому релизу на GitHub:
Этот пример устанавливает сборку для 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
Вы теперь находитесь в гостевой системе. Выполните 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 удаляет их; именованные тома остаются до
явного удаления. См. руководство по CLI для снимков, томов,
блокировок образов и настройки systemd.
exec, установка systemd, импорт virsh
и doctor.holos.yaml./dev/kvmqemu-system-x86_64qemu-imgcloud-localds, genisoimage, mkisofs или xorrisossh для holos exec и healthchecksЗапустите holos doctor для проверки хоста.
Проверьте id -nG и ls -l /dev/kvm. На хостах, где устройство принадлежит группе
kvm, добавьте пользователя командой sudo usermod -aG kvm "$USER", затем выйдите
из системы и подключитесь заново. Существующие оболочки сохраняют старое членство в группе. Запустите
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 завершается ошибкой на macOSKVM — это функция ядра Linux. Бинарные файлы для macOS полезны для написания конфигураций и
офлайн-команд, но holos up и holos run должны выполняться на Linux-хосте с KVM.
holos — это не Kubernetes. Он не пытается решать задачи кластеризации нескольких хостов, живой миграции, service mesh, overlay-сетей, планировщиков, CRD или кворума control plane.
Цель — сделать KVM удобным для стеков на одном хосте, не перенимая операционную модель Kubernetes.
Лицензировано под Apache License, Version 2.0. См.
NOTICE для указания авторства.