
holos v0.6.2
Декларативный инструмент оркестрации виртуальных машин 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.
Документация
- Сайт: целевая страница и отрендеренная документация.
- Руководство по CLI: ad hoc виртуальные машины,
exec, установка systemd, импорт virsh иdoctor. - Файл Compose: сервисы, тома, healthchecks, сеть, проброс PCI, провижининг через Dockerfile и значения по умолчанию.
- JSON Schema: автодополнение и валидация в редакторе для
holos.yaml. - Примеры: запускаемые и шаблонные стеки с пояснениями в стиле README.
- Отсутствующие функции: приоритизированные пробелы, соответствующие цели holos — compose для KVM на одном хосте.
- Разработка: сборка, тестирование, требования к хосту и процесс релиза.
- Политика безопасности: поддерживаемые версии и приватное сообщение об уязвимостях.
- Модель угроз / усиление защиты: проверка образов, права доступа к состоянию, блокировки и операционные рекомендации.
- Участие в разработке: сборка, тестирование, стиль и соглашения для PR.
Требования к хосту
- Linux с
/dev/kvm qemu-system-x86_64qemu-img- Одна из утилит:
cloud-localds,genisoimage,mkisofsилиxorriso - Прошивка OVMF / edk2-ovmf для UEFI или проброса PCI
sshдляholos execи healthchecks
Запустите holos doctor для проверки хоста.
Устранение неполадок
Permission denied при открытии /dev/kvm
Проверьте id -nG и ls -l /dev/kvm. На хостах, где устройство принадлежит группе
kvm, добавьте пользователя командой sudo usermod -aG kvm "$USER", затем выйдите
из системы и подключитесь заново. Существующие оболочки сохраняют старое членство в группе. Запустите
holos doctor снова из новой сессии.
SSH сбрасывает соединение при первой загрузке
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 завершается ошибкой на macOS
KVM — это функция ядра Linux. Бинарные файлы для macOS полезны для написания конфигураций и
офлайн-команд, но holos up и holos run должны выполняться на Linux-хосте с KVM.
Нецели
holos — это не Kubernetes. Он не пытается решать задачи кластеризации нескольких хостов, живой миграции, service mesh, overlay-сетей, планировщиков, CRD или кворума control plane.
Цель — сделать KVM удобным для стеков на одном хосте, не перенимая операционную модель Kubernetes.
Лицензия
Лицензировано под Apache License, Version 2.0. См.
NOTICE для указания авторства.