Vagrantからの卒業: DebianにおけるKVMとVirshを使ったVM
Ditching Vagrant: VMs with KVM and Virsh on Debian (benjamintoll.com)
要約
筆者は、長年利用してきた仮想マシン管理ツールVagrantから、DebianネイティブのKVMとlibvirt/virshへの移行を決断しました。Vagrantが自身のワークフローにとって過剰なソフトウェアであると感じたためです。記事では、KVM、libvirt、virshの概要と連携方法を解説し、Debianのアップグレード後に発生したシリアル出力の問題を解決するために、virt-installを用いたプリシードによるVM作成方法を紹介しています。
全文翻訳
Vagrantからの移行
さようなら、古い友よ。2010年から共に旅をしてきた君は、まずVirtualBox、そして後にlibvirtとKVMで、私の仮想マシンのあらゆるニーズを忠実に満たしてくれた。しかし、古来より言われるように、良いものもいつかは終わる。
何が起こったのか?何が変わったのか?
はじめに
さて、ここで何をしているのか?なぜ別れを選ぶのか?正直に言って、Vagrantは私のような小さな人間にはあまりにも多くのソフトウェアだと感じている。この短い人生を学び続け、ますます多くのことに触れるにつれて、以前はそれほど知らなかった頃の選択を問い直し、再評価している。私は常に過去のプロジェクトや決定を見直しており、それは私にとって良い結果をもたらしてきた。この場合、ワークフローが複雑になりすぎていることに気づいた。
2010年にVagrantを使い始めたとき、VMのライフサイクルを管理してくれるだけで満足していた。Vagrantボックスはクールで時間を節約してくれたし、その後Ansibleを使い始めたときには、Vagrantの組み込みAnsibleサポートでマシンをプロビジョニングし始めた。
しかし、Linuxについてますます学ぶにつれて、なぜVagrantの代わりにKVMを使わないのだろうか、と疑問に思うようになった。結局のところ、バージョン2.6.20以降Linuxカーネルにマージされており、仮想マシンを作成・管理するために必要なツールはすでに持っているのだ。Linuxがネイティブにできることを、なぜ別のソフトウェアレイヤー、別の抽象化が必要なのだろうか?
私は弱虫になったような気がした。臭い小汚い奴になったような気がした。最悪なことに、自分が怠惰だったことに気づいた。そこで、数年前にVirtualBoxプロバイダーからlibvirtプロバイダーに半端な措置として切り替え、その後は人生を進めていった。結局、もっと重要なことがたくさんあった。例えば、当時の雇用主とその顧客のために非常に一生懸命働くことだ。彼らはそれが重要で、最も重要なことで、あまりにも重要なので、アジャイルとスクラムマスターのせいで、平日に直す時間がなかった急ごしらえのインフラを修正するために、連続して早朝3時に起きるべきだと言われた。それは顧客に価値を提供しなかったからだ。
とにかく、この恥ずべき行動を数年続けた後、ついにKVMとlibvirtを掘り下げて正しく行うための時間を確保した。そう、子供たちよ、Vagrant2をアンインストールしたら、妻は再び私を愛するようになった。
では、何をしたのか?さあ、私の周りに集まって、一緒に学ぼう。
KVMとlibvirtとvirsh
KVMは、Linuxカーネルがハイパーバイザーとして機能し、カーネルの仮想化モジュールを介して仮想マシン(VM)を作成・実行できるようにする。仮想化を通じて、ハードウェアはソフトウェアでエミュレートされるため、VMを作成することは、ホストOS内に完全なOSを持つようなものだ。クールだろ?もちろんだ!
カーネルモジュールはおそらく有効になっている。確認するには:
$ lsmod | ag kvm
kvm_intel 380928 0
kvm 1146880 1 kvm_intel
irqbypass 16384 1 kvm
または:
$ ls /dev/kvm
/dev/kvm
一方、libvirtは、KVMやXen、LXC、QEMUなどの他の仮想化プラットフォームを管理するライブラリとネットワークデーモン(「デーモン」と発音)である。VMの作成、開始、停止、一時停止、削除など、ストレージやネットワーク管理といった他の多くの機能も可能にする。libvirtの素晴らしい点は、サポートするさまざまなプラットフォームと対話する際に統一された共通のライブラリを提供してくれるため、他のものを使用したり、ハイパーバイザーごとに異なるコマンドや操作を学習したりする必要がないことだ。つまり、仮想化バックエンドを切り替えても、同じコマンドでlibvirtを使い続けることができる。
インストールするには:
$ sudo apt-get install libvirt-daemon-system
virshは、libvirtのコマンドラインフロントエンドである(libvirtはvirt-managerのような他のフロントエンドもサポートしているが、それはGUIであり、CLIツールがある場合にGUIを使用する人がいないことは誰もが知っている)。これはlibvirtデーモンと対話するための優れた抽象化レイヤーを提供し、libvirtデーモンはKVMと対話する。
インストールするには:
$ sudo apt-get install libvirt-clients virtinst
これにより
virt-installもインストールされる。
仮想マシン(ドメイン)に関する情報を取得するための便利なvirshコマンドをいくつか紹介する:
domblkinfodomblkstatdomiddomiflistdomifstatdominfodommemstatdomnamedomstatedomuuid
ホストやノードに関する情報を取得するには:
capabilitieshostnamenodeinfo
そして、便利な管理コマンド:
connectdestroydumpxmleditlistrebootshutdownstartundefinepool-listpool-destroypool-undefinevol-listvol-delete
ここにリストするにはあまりにも多い。virshのドキュメントを参照してほしい。
再度、概念モデルはユーザー ->
virsh->libvirt-> KVM である。
これらのトピックのそれぞれについて理解すべきことはもっとたくさんあるが、これで始められるだろう。このトピックに関する素晴らしい記事をいくつか紹介する:
あらら
私はlibvirtとKVMを使って仮想マシンを楽しく作成していた。何の心配もなかった。すると突然、私の世界は完全に崩壊した。bookwormからtrixieにアップグレードしたのだが、VMを起動してもシリアル出力が得られなくなったのだ。
VMとホスト間のシリアルポート経由の通信を有効にするために、いつものようにvirt-installコマンド(後述)でカーネルブートパラメータを渡していたのだが、それがVM(つまりブートローダー設定)に実際に書き込まれていないようだった。
grub(または使用しているブートローダー)に実際に書き込まれたパラメータを確認するには、仮想マシンにログインしてgrub設定を開く:
/etc/default/grub重要な行は次のようになるはずだ:
GRUB_CMDLINE_LINUX_DEFAULT="quiet" GRUB_CMDLINE_LINUX="console=ttyS0,115200"何か変更した場合は、次のコマンドを実行する:
$ sudo grub-mkconfig -o /boot/grub/grub.cfg $ sudo reboot
私は考え、何が変わったのかを(おそらく長時間をかけて)デバッグするのではなく、別の方法でアプローチすることにした。代わりに、プリシードド仮想マシンと呼ばれるものを作成する設定ファイルをインストールコマンドに渡すことにした。これは全体的により良い解決策だ。なぜなら、ビルドを決定論的でバージョン管理可能にし(ビルドマシンからアクセスできる場所に置く)、ファイルで指定した値が仮想マシンに書き込まれることを保証してくれるからだ。
さらに、すべてのマシンに共通して持つべきソフトウェアをプリインストールしておき、後でcloud-initのようなものを使用してVM作成ライフサイクルにフックし、各マシン固有の追加ソフトウェアを追加することもできる。素晴らしい!
それでは、それを見てみよう。
プリシーディング
では、プリシーディングとは何か?前の発言から推測したかもしれないが、プリシーディングは、ローカライゼーション、ユーザー名とパスワード、インストールパッケージなど、インストール中に尋ねられる質問にあらかじめ定義された回答を提供することで、仮想マシンの作成を自動化する方法だ。いつものことだが、何度も経験したことだ。
preseedingという言葉は主にDebianビルドの文脈で使われているのを見たことがあるが、他のオペレーティングシステムにも同様の方法がある。
Debian trixieは、独自のベースとして使用できる例の事前設定ファイルを親切に提供している。Automating the installation using preseedingで、さらに素晴らしい情報を参照してほしい。これは素晴らしい読み物であり、強く推奨する。
これはすべて素晴らしいように聞こえ、あなたはきっと驚嘆しているだろう。そして今、どうやって始めればいいのか知りたいと思っているはずだ。そこで、前述の小さな友人であるvirt-installが登場する:
$ virt-install \
--connect qemu:///system \
--name kilgore-trout \
--memory 8192 \
--extra-args="preseed/file=/preseed.cfg console=ttyS0,115200n8" \
--initrd-inject ./preseed.cfg \
--install debian13 \
--disk size=40 \
--filesystem type=mount,source=/home/btoll/libvirt/kilgore-trout/mnt,target=shared,accessmode=mapped,driver.type=path,driver.wrpolicy=immediate \
--network network=default \
--graphics none
パラメータとその値を見てみよう(値のほとんどはvirt-installのmanページからそのままコピー):
| パラメータ |
| --- | --- |
| --connect | 非デフォルトハイパーバイザーに接続する。指定しない場合、libvirtは最も適切なデフォルトを選択しようとする。システムlibvirtdインスタンスで実行されるKVMおよびQEMUゲストを作成する場合。これはvirt-managerが使用するデフォルトモードであり、ほとんどのKVMユーザーが望むものである。 |
| --name | 新しいゲスト仮想マシンインスタンスの名前。接続上のすべてのゲスト(現在アクティブでないものを含む)の中で一意である必要がある。 |
| --memory | ゲストに割り当てるメモリ(MiB単位)。 |
| --extra-args | ゲストのインストールを実行する際にインストーラーに渡す追加のカーネルコマンドライン引数。 |
| --initrd-inject | --extra-argsで参照されるpreseedファイルがホスト上にある場所。 |
| --install | virt-installはlibosinfoから--location URLを取得し、そこからデフォルトを埋める。 |
| --disk | 40GBの新しいディスクイメージと関連付けられたディスクデバイスを作成する。virt-installはパス名を生成し、ハイパーバイザーのデフォルトイメージ場所に配置する。 |
| --filesystem | ホスト上のディレクトリをゲストにエクスポートすることを指定する。 |
| --network | ゲストをホストネットワークに接続する。ネットワークはホストネットワークから分離され、仮想ブリッジで接続される。 |
| --graphics | ヘッドレスとしてインストールする。ゲストは通常、ゲストの最初のシリアルポートでテキストコンソールが設定されている必要がある(これは--extra-argsオプションを介して行うことができる)。 |
--extra-argsにconsole=ttyS0,115200n8がないと、仮想マシン(VM)が起動したときにハングするように見えるが、実際にはハングしていない。問題は、ターミナルと仮想マシンの間に接続がないため、シリアルポートからのログ出力が画面に表示されないことだ。接続がないからだ。
上記のコマンドは、qemu:///sessionデーモンに対して実行している場合は失敗する。ネットワークはシステム全体で利用可能である必要がある(uri文字列に注意):
$ virsh --connect qemu:///system net-list --all
Name State Autostart Persistent
----------------------------------------------------
default active yes yes
vagrant-libvirt active no yes
ちなみに、vagrant-libvirtネットワークが表示されているのは、Vagrantをlibvirtプロバイダーで使用していたためだ。
上記のコマンドのようなvirt-installコマンドが正常に実行されると、ログインプロンプトが表示される:
$ virsh -c qemu:///system list --all
Id Name State
--------------------------------
- kilgore-trout shut off
$ virsh -c qemu:///system start kilgore-trout
Domain 'kilgore-trout' started
$ virsh -c qemu:///system console kilgore-trout
Connected to domain 'kilgore-trout'
Escape character is ^] (Ctrl + ])
The highlighted entry will be executed automatically in 0s.
Booting `Debian GNU/Linux'
Loading Linux 6.12.94+deb13-amd64 ...
Loading initial ramdisk ...
/dev/mapper/kilgore--trout--vg-root: clean, 51705/2428272 files, 650933/9700352 blocks
[ 2.375045] systemd-ssh-generator[287]: Failed to query local AF_VSOCK CID: Cannot assign requested address
[ 2.376760] (sd-exec-[279]: /usr/lib/systemd/system-generators/systemd-ssh-generator failed with exit status 1.
Debian GNU/Linux 13 kilgore-trout ttyS0
kilgore-trout login: btoll
Password:
Linux kilgore-trout 6.12.94+deb13-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.12.94-1 (2026-06-20) x86_64
The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.
Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
ログイン後、ネットワーク接続を確認しよう。
ネットワーク接続
btoll@kilgore-trout:~$ ip a
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host noprefixroute
valid_lft forever preferred_lft forever
2: enp2s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
link/ether 52:54:00:52:b4:2d brd ff:ff:ff:ff:ff:ff
altname enx52540052b42d
inet 192.168.122.112/24 brd 192.168.122.255 scope global dynamic noprefixroute enp2s0
valid_lft 3420sec preferred_lft 2970sec
inet6 fe80::c7e7:221f:751d:773c/64 scope link
valid_lft forever preferred_lft forever
btoll@kilgore-trout:~$ ip route
default via 192.168.122.1 dev enp2s0 proto dhcp src 192.168.122.112 metric 1002
192.168.122.0/24 dev enp2s0 proto dhcp scope link src 192.168.122.112 metric 1002
btoll@kilgore-trout:~$ ping benjamintoll.com
PING benjamintoll.com (167.114.97.28) 56(84) bytes of data.
64 bytes from dinesh (167.114.97.28): icmp_seq=1 ttl=44 time=44.0 ms
64 bytes from dinesh (167.114.97.28): icmp_seq=2 ttl=44 time=43.5 ms
64 bytes from dinesh (167.114.97.28): icmp_seq=3 ttl=44 time=40.8 ms
--- benjamintoll.com ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2004ms
rtt min/avg/max/mdev = 40.781/42.771/43.993/1.419 ms
そして、ホスト上でipを使用して:
$ ip link show type bridge
4: virbr0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP mode DEFAULT group default qlen 1000
link/ether 52:54:00:9d:81:89 brd ff:ff:ff:ff:ff:ff
$ ip addr show dev virbr0
4: virbr0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000
link/ether 52:54:00:9d:81:89 brd ff:ff:ff:ff:ff:ff
inet 192.168.122.1/24 brd 192.168.122.255 scope global virbr0
valid_lft forever preferred_lft forever
$ ip a show dev vnet46
77: vnet46: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue master virbr0 state UNKNOWN group default qlen 1000
link/ether fe:54:00:c7:5e:c3 brd ff:ff:ff:ff:ff:ff
inet6 fe80::fc54:ff:fec7:5ec3/64 scope link proto kernel_ll
valid_lft forever preferred_lft forever
または:
$ ip link show dev vnet46
77: vnet46: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue master virbr0 state UNKNOWN mode DEFAULT group default qlen 1000
link/ether fe:54:00:c7:5e:c3 brd ff:ff:ff:ff:ff:ff
libvirtはvirbr0仮想ブリッジを作成し、192.168.122.0/24ネットワークを分離した。素晴らしい。
brctlユーティリティがインストールされていれば、それを使用することもできる:
$ brctl show virbr0
bridge name bridge id STP enabled interfaces
virbr0 8000.5254009d8189 yes vnet46
仮想ネットワークインターフェイス名vnet46の名前から、virshを使用してさらに情報を取得しよう:
$ virsh --connect qemu:///system domifaddr kilgore-trout
Name MAC address Protocol Address
-------------------------------------------------------------------------------
vnet46 52:54:00:c7:5e:c3 ipv4 192.168.122.113/24
VM内:
$ ip a show
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host noprefixroute
valid_lft forever preferred_lft forever
2: enp2s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
link/ether 52:54:00:c7:5e:c3 brd ff:ff:ff:ff:ff:ff
altname enx525400c75ec3
inet 192.168.122.113/24 brd 192.168.122.255 scope global dynamic noprefixroute enp2s0
valid_lft 2537sec preferred_lft 1880sec
inet6 fe80::e708:62a0:9e79:ddcc/64 scope link
valid_lft forever preferred_lft forever
このdynamicというキーワードは、IPアドレスがDHCP(libvirtはdnsmasqを使用)を介してリースされたことを示している。リースの期間は次の行で指定されている(valid_lft 2537sec preferred_lft 1880sec):
valid_lft- (有効期間) = アドレスが期限切れになるまでの2819秒(約47分)preferred_lft(推奨期間) = システムが更新すべきまでの2162秒(約36分)
MACアドレスの最後の3オクテット(c7:5e:c3)がホスト上のデバイスと同じであることに注意してほしい。これは、これがTAPデバイスの一方のエンドポイントであり、もう一方はホスト上のvnet46デバイスであることを示している。このTAPデバイスは、2つの異なるネットワーク名前空間を接続する仮想イーサネットケーブルのように機能する。
次にマウントデバイスを確認しよう。
マウント
もちろん、ホストから共有されるディレクトリが存在することは言うまでもない。存在しない場合、
virt-installは失敗する。
VM内:
$ mount --type 9p
shared on /mnt/shared type 9p (rw,relatime,cache=0xf,access=client,trans=virtio)
9Pとは何か?これはPlan 9 from Bell Labs分散オペレーティングシステムのために開発されたネットワークプロトコルであり、当初はKen ThompsonとRob Pikeが主導していた。彼らはUnixとCを開発したのと同じグループの一員だ。すごい。
クール。それでは、マウントされたsharedディレクトリに移動しよう。
btoll@kilgore-trout:~$ cd /mnt/shared/
btoll@kilgore-trout:/mnt/shared$ touch grass
touch: cannot touch 'grass': Permission denied
これを修正するためにホスト上のパーミッションを開く必要があるが、これは後でさらに調査する必要があるだろう。
$ chmod 777 mnt
VMに戻って:
btoll@kilgore-trout:/mnt/shared$ touch grass
btoll@kilgore-trout:/mnt/shared$ ls
grass
解決策ではないが、応急処置だ。人生にはもっと悪いこともある。
SSHエージェントフォワーディング
SSHエージェントフォワーディングを有効にする:
$ eval $(ssh-agent) && ssh-add ~/.ssh/your_private_key
$ ssh -A 192.168.122.114
VMにログインして、アクション(リポジトリのクローンなど)を実行する権限がないことに気づいた場合は、フォワーディングが成功したか確認する:
$ ssh-add -l
256 SHA256:SYtbHfjUelfldW4+nK7YVT/O9mMZRPKSnaU4kgN9LG4 ben@benjamintoll.com (ED25519)
もちろん、いつでもconsoleコマンドを使用してVMにログインできる:
$ virsh --connect qemu:///system console kilgore-trout
よし、これでVagrantではなくvirshを使って仮想マシンを作成するのに十分なところまで来た。
$ virsh -c qemu:///system dumpxml kilgore-trout
まとめ
明白なことから始めよう:これは素晴らしい概要だ。簡潔だが、Marky MarkとCalvin Kleinはそれを止められなかった。
参考文献
- ディープステート。
- まあ、それは嘘だ。まだ私のマシンにある。