管理虚拟机

管理虚拟机

概述

StratoVirt可以查询虚拟机信息并对虚拟机的资源和生命周期进行管理。由于StratoVirt使用QMP管理虚拟机，所以查询虚拟机信息，也需要先连接到虚拟机。

查询虚拟机信息

简介：

StratoVirt可以查询虚拟机状态、vCPU拓扑信息、vCPU上线情况等。

查询状态

使用query-status命令查询虚拟机的运行状态。

用法：

{ “execute”: “query-status” }
示例：

<- { "execute": "query-status" }
-> { "return": { "running": true,"singlestep": false,"status": "running" }

查询拓扑

使用query-cpus命令查询所有CPU的拓扑结构。

用法：

{ “execute”: “query-cpus” }

示例：

<- { "execute": "query-cpus" }
-> {"return":[{"CPU":0,"arch":"x86","current":true,"halted":false,"props":{"core-id":0,"socket-id":0,"thread-id":0},"qom_path":"/machine/unattached/device[0]","thread_id":8439},{"CPU":1,"arch":"x86","current":true,"halted":false,"props":{"core-id":0,"socket-id":1,"thread-id":0},"qom_path":"/machine/unattached/device[1]","thread_id":8440}]}

查询vCPU上线情况

使用query-hotpluggable-cpus命令查询所有vCPU的online/offline情况。

用法：

{ “execute”: “query-hotpluggable-cpus” }

示例：

<- { "execute": "query-hotpluggable-cpus" }
-> {"return":[{"props":{"core-id":0,"socket-id":0,"thread-id":0},"qom-path":"/machine/unattached/device[0]","type":"host-x86-cpu","vcpus-count":1},{"props":{"core-id":0,"socket-id":1,"thread-id":0},"qom-path":"/machine/unattached/device[1]","type":"host-x86-cpu","vcpus-count":1}]}

其中，online的vCPU具有qom-path项，offline的vCPU则没有。

管理虚拟机生命周期

简介

StratoVirt可以对虚拟机进行启动、暂停、恢复、退出等生命周期进行管理。

创建并启动虚拟机

根据虚拟机配置可知，可以通过命令行参数或json文件指定虚拟机配置，并在主机通过stratovirt命令创建并启动虚拟机。

使用命令行参数给出虚拟机配置，创建并启动虚拟机的命令如下：

$ /path/to/stratovirt -[参数1] [参数选项] -[参数2] [参数选项] ...

使用json文件给出虚拟机配置，创建并启动虚拟机的命令如下：

$ /path/to/stratovirt \
    -config /path/to/json \
    -qmp unix:/path/to/socket

其中，/path/to/json为json配置文件的路径。/path/to/socket为用户指定的socket文件（如/tmp/stratovirt.socket），使用上述命令会自动创建socket文件。为确保虚拟机能够正常启动，在创建socket文件前确保该文件不存在。

虚拟机启动后，内部会有eth0和eth1两张网卡。这两张网卡预留用于网卡热插拔。热插的第一张网卡是eth0，热插的第二张网卡是eth1，目前只支持热插2张virtio-net网卡。

连接虚拟机

StratoVirt当前采用QMP管理虚拟机，暂停、恢复、退出虚拟机等操作需要通过QMP连接到虚拟机进行管理。

在主机上打开新的命令行窗口B，并使用root权限进行api-channel连接，参考命令如下：

# ncat -U /path/to/socket

连接建立后，会收到来自StratoVirt的问候消息，如下所示：

{"QMP":{"version":{"qemu":{"micro":1,"minor":0,"major":4},"package":""},"capabilities":[]}}

现在，可以在窗口B中输入QMP命令来管理虚拟机。

QMP提供了stop、cont、quit和query-status等来管理和查询虚拟机状态。

管理虚拟机的QMP命令均在窗口B中进行输入。符号：<-表示命令输入，->表示QMP结果返回。

暂停虚拟机

QMP提供了stop命令用于暂停虚拟机，即暂停虚拟机所有的vCPU。命令格式如下：

{“execute”:”stop”}

示例：

使用stop暂停该虚拟机的命令和回显如下：

<- {"execute":"stop"}
-> {"event":"STOP","data":{},"timestamp":{"seconds":1583908726,"microseconds":162739}}
-> {"return":{}}

恢复虚拟机

QMP提供了cont命令用于恢复处于暂停状态suspend的虚拟机，即恢复虚拟机所有vCPU的运行。命令格式如下：

{“execute”:”cont”}

示例：

使用cont恢复该虚拟机的命令和回显如下：

<- {"execute":"cont"}
-> {"event":"RESUME","data":{},"timestamp":{"seconds":1583908853,"microseconds":411394}}
-> {"return":{}}

退出虚拟机

QMP提供了quit命令用于退出虚拟机，即退出StratoVirt进程。命令格式如下：

{“execute”:”quit”}

示例：

<- {"execute":"quit"}
-> {"return":{}}
-> {"event":"SHUTDOWN","data":{"guest":false,"reason":"host-qmp-quit"},"timestamp":{"ds":1590563776,"microseconds":519808}}

管理虚拟机资源

热插拔磁盘

StratoVirt支持在虚拟机运行过程中调整磁盘数量，即在不中断业务前提下，增加或删除虚拟机磁盘。

热插磁盘

用法：

{"execute": "blockdev-add", "arguments": {"node-name": "drive-0", "file": {"driver": "file", "filename": "/path/to/block"}, "cache": {"direct": true}, "read-only": false}}
{"execute": "device_add", "arguments": {"id": "drive-0", "driver": "virtio-blk-mmio", "addr": "0x1"}}

参数

blockdev-add中的node-name要和device_add中的id一致，如上都是drive-0。
/path/to/block是被热插磁盘的镜像路径，不能是启动rootfs的磁盘镜像。
对于addr来说，它从0x0开始与虚拟机的vda映射，0x1与vdb映射，以此类推。为了兼容QMP协议，”addr”也可以用”lun”代替，但是lun=0与客户机的vdb映射。
由于stratovirt支持的最大virtio-blk磁盘数量是6个，热插磁盘时请注意规格约束。

示例

<- {"execute": "blockdev-add", "arguments": {"node-name": "drive-0", "file": {"driver": "file", "filename": "/path/to/block"}, "cache": {"direct": true}, "read-only": false}}
-> {"return": {}}
<- {"execute": "device_add", "arguments": {"id": "drive-0", "driver": "virtio-blk-mmio", "addr": "0x1"}}
-> {"return": {}}

热拔磁盘

用法：

{“execute”: “device_del”, “arguments”: {“id”:”drive-0”}}

参数：

id 为热拔磁盘的ID号。

示例

<- {"execute": "device_del", "arguments": {"id": "drive-0"}}
-> {"event":"DEVICE_DELETED","data":{"device":"drive-0","path":"drive-0"},"timestamp":{"seconds":1598513162,"microseconds":367129}}
-> {"return": {}}

热插拔网卡

StratoVirt支持在虚拟机运行过程中调整网卡数量，即在不中断业务前提下，给虚拟机增加或删除网卡。

热插网卡

准备工作（需要使用root权限）

创建并启用Linux网桥，例如网桥名为 qbr0 的参考命令如下：

# brctl addbr qbr0
# ifconfig qbr0 up

创建并启用 tap 设备，例如设备名为 tap0 的参考命令如下：

# ip tuntap add tap0 mode tap
# ifconfig tap0 up

添加 tap 设备到网桥：

# brctl addif qbr0 tap0

用法

{"execute":"netdev_add", "arguments":{"id":"net-0", "ifname":"tap0"}}
{"execute":"device_add", "arguments":{"id":"net-0", "driver":"virtio-net-mmio", "addr":"0x0"}}

参数

netdev_add中的id应该和device_add中的id一致，ifname是后端的tap设备名称。
对于addr来说，它从0x0开始与虚拟机的eth0映射，0x1和虚拟机的eth1映射。
由于stratovirt支持的最大virtio-net数量为2个，热插网卡时请注意规格约束。

示例

<- {"execute":"netdev_add", "arguments":{"id":"net-0", "ifname":"tap0"}}
-> {"return": {}}
<- {"execute":"device_add", "arguments":{"id":"net-0", "driver":"virtio-net-mmio", "addr":"0x0"}} 
-> {"return": {}}

其中，addr:0x0,对应虚拟机内部的eth0。

热拔网卡

用法

{“execute”: “device_del”, “arguments”: {“id”: “net-0”}}

参数

id：网卡的ID号，例如net-0。

示例

<- {"execute": "device_del", "arguments": {"id": "net-0"}}
-> {"event":"DEVICE_DELETED","data":{"device":"net-0","path":"net-0"},"timestamp":{"seconds":1598513339,"microseconds":97310}}
-> {"return": {}}

Ballon设备使用

使用balloon设备可以从虚拟机回收空闲的内存。Balloon通过qmp命令来调用。qmp命令使用如下：

用法：

{"execute": "balloon", "arguments": {"value": 2147483648‬}}

参数：

value：想要设置的guest内存大小值，单位为字节。如果该值大于虚拟机启动时配置的内存值，则以启动时配置的内存值为准。

示例：

启动时配置的内存大小为4GiB，在虚拟机内部通过free命令查询虚拟机空闲内存大于2GiB，那么可以通过qmp命令设置guest内存大小为2147483648字节。

<- {"execute": "balloon", "arguments": {"value": 2147483648‬}}
-> {"return": {}}

查询虚拟机的当前实际内存：

<- {"execute": "query-balloon"}
-> {"return":{"actual":2147483648}}

虚拟机内存快照

简介

虚拟机内存快照是指将虚拟机的设备状态和内存信息保存在快照文件中。当虚拟机系统损坏时，可以使用内存快照将虚拟机恢复到快照对应时间点，从而提升系统的可靠性。

StratoVirt 支持对处于暂停状态（suspend）的虚拟机制作快照，并且支持虚拟机以快照文件为虚拟机模板批量创建新的虚拟机。只要制作快照的时间点在虚拟机启动完成并进入用户态之后，快速启动就能够跳过内核启动阶段和用户态服务初始化阶段，在毫秒级完成虚拟机启动。

互斥特性

虚拟机配置了如下设备或使用了如下特性时，不能制作和使用内存快照：

vhost-net 设备
vfio 直通设备
balloon 设备
大页内存
mem-shared 特性
配置了内存后端文件 mem-path

制作快照

针对 StratoVirt 虚拟机，可以参考如下步骤制作存储快照：

创建并启动虚拟机。

在 Host 上执行 QMP 命令暂停虚拟机：

<- {"execute":"stop"}
-> {"event":"STOP","data":{},"timestamp":{"seconds":1583908726,"microseconds":162739}}
-> {"return":{}}

确认虚拟机处于暂停状态：

<- {"execute":"query-status"}
-> {"return":{"running":true,"singlestep":false,"status":"paused"}}

执行如下 QMP 命令，在任一指定的绝对路径下创建虚拟机快照，例如 /path/to/template 路径，参考命令如下：
```
<- {"execute":"migrate", "arguments":{"uri":"file:/path/to/template"}}
-> {"return":{}}
```
确认快照是否创建成功。
```
<- {"execute":"query-migrate"}
```
如果回显 {“return”:{“status”:”completed”}} ，说明快照创建成功。

快照创建成功，会在指定路径 /path/to/template 生成 memory 和 state 两个目录。state文件包含虚拟机设备状态的信息，memory文件包含虚拟机内存的数据信息，memory 文件大小接近配置的虚拟机内存。

查询快照状态

当前在整个快照过程中，存在5种状态：

None: 快照资源没有准备完成
Setup: 快照资源准备完成，可以进行快照
Active: 处于制作快照状态中
Completed: 快照制作成功
Failed: 快照制作失败

可以通过在 Host 执行query-migrateqmp 命令查询当前快照的状态，如当虚拟机快照制作成功时查询：

<- {"execute":"query-migrate"}
-> {"return":{"status":"completed"}}

恢复虚拟机

注意事项

快照以及从快照启动特性支持的机型包括：
- microvm
- q35（x86_64）
- virt（aarch64平台）
在使用快照恢复时，配置的设备必须与制作快照时保持一致
当使用 microvm 机型，并且在快照前使用了磁盘/网卡的热插特性，在恢复时需要将热插的磁盘/网卡配置进启动命令行

从快照文件中恢复虚拟机

命令格式

stratovirt -incoming URI

参数说明

URI：快照的路径，当前版本只支持 file 类型，后加上快照文件的绝对路径

示例

假设制作快照所使用的虚拟机是通过以下命令创建的：

$ stratovirt \
    -machine microvm \
    -kernel /path/to/kernel \
    -smp 1 -m 1024 \
    -append "console=ttyS0 pci=off reboot=k quiet panic=1 root=/dev/vda" \
    -drive file=/path/to/rootfs,id=rootfs,readonly=off,direct=off \
    -device virtio-blk-device,drive=rootfs \
    -qmp unix:/path/to/socket,server,nowait \
    -serial stdio

那么，使用快照恢复虚拟机的参考命令如下（此处假设快照存放的路径为 /path/to/template ）:

$ stratovirt \
    -machine microvm \
    -kernel /path/to/kernel \
    -smp 1 -m 1024 \
    -append "console=ttyS0 pci=off reboot=k quiet panic=1 root=/dev/vda" \
    -drive file=/path/to/rootfs,id=rootfs,readonly=off,direct=off \
    -device virtio-blk-device,drive=rootfs \
    -qmp unix:/path/to/another_socket,server,nowait \
    -serial stdio \
    -incoming file:/path/to/template

虚拟机管理

管理虚拟机

概述

查询虚拟机信息

简介：

查询状态

查询拓扑

查询vCPU上线情况

管理虚拟机生命周期

简介

创建并启动虚拟机

连接虚拟机

暂停虚拟机

恢复虚拟机

退出虚拟机

管理虚拟机资源

热插拔磁盘

热插磁盘

热拔磁盘

热插拔网卡

热插网卡

热拔网卡

Ballon设备使用

虚拟机内存快照

简介

互斥特性

制作快照

查询快照状态

恢复虚拟机

注意事项

从快照文件中恢复虚拟机