
YAMLコンポーズファイルを使用する宣言型KVM/QEMU VMオーケストレーションツール。libvirtやXMLを使わずに、cloud-init、SSH、PCIパススルー、イメージ検証を備えたマルチVMスタックを管理します。
KVM 用の Docker compose。1 つの YAML ファイルでマルチ VM スタックを定義できます。libvirt も XML も分散コントロールプレーンも不要です。
ウェブサイトとドキュメント: https://zeroecco.github.io/holos/
基本単位はコンテナではなく VM です。各ワークロードインスタンスには、独自のカーネル境界、qcow2 オーバーレイ、cloud-init シード、および生成された SSH アクセスが割り当てられます。
/dev/kvm、QEMU、および cloud-init シードビルダーを備えた Linux ホスト上で VM を実行します。ホスト要件を参照してください。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
ゲストを再度終了し、その後、使い捨て VM を削除します:
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 は VM を起動しますが、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 のようなインスタンス名を使用してください。
VM を置き換えたり削除したりする変更には holos up --recreate が必要です。置き換えはその VM のルートディスクを削除するため、まずプレビューを確認してください。名前付きボリュームは保持されます。古いリリースで作成されたプロジェクトを更新する前に、更新ガイドを参照してください。
この使い捨てスタックでの作業が終わったら:
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" でユーザーを追加し、ログアウトして再接続してください。既存のシェルは古いグループメンバーシップを保持したままです。新しいセッションから再度 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、コントロールプレーンのクォーラムを解決しようとはしません。
目標は、Kubernetes の運用形態を持ち込むことなく、シングルホストのスタックで KVM を実用的にすることです。
Apache License, Version 2.0 の下でライセンスされています。帰属表示については NOTICE を参照してください。