玩转虚拟化测试框架avocado-vt之安装部署

kezhiming2021-01-20virttestavocado-vt

简介

本文以openeuler版本为例，介绍虚拟化框架avocado-vt的部署及应用，指导用户开展虚拟化组件测试。

为了更好地理解整个应用过程，我们需要首先了解以下基本概念：

Avocado：Avocado是一套帮助自动化测试的工具和库，源于autotest，最主要的优势包括可以多种形式的结果呈现、提供了多个实用的程序模块、可通过插件扩展等；
更多信息可参见官方指导https://avocado-framework.readthedocs.io/en/latest/index.html
Avocado-VT：Avocado-VT是一个虚拟化测试插件，提供与虚拟化测试相关的原子，并提供Avocado提供的所有便利；
更多信息可参见官方指导https://avocado-vt.readthedocs.io/en/latest/index.html
Tp（test-providers）：主要是提供组件测试用例集，当前openEuler上已有tp-libvirt/tp-qemu；

测试部署环境准备

基础rpm包安装
虚拟化组件包安装，qemu、libvirt、edk2等
框架依赖包，git、gcc、python3-pip、python3-devel、tcpdump、nc、diffutils、iputils等
pip3源配置
avocado/avocado-vt部署时，需要通过pip3安装python第三方库，如果不配置，则通过pip3从python官方库获取第三方库。基于用户实际网络情况，选择配置pip3，可一定程度上提升下载的速率及稳定性。
使用如下命令可配置，如配置tsinghua的源
```
pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
```
其他配置
基于用户的实际网络环境，如果测试环境有做相关的网络隔离，根据实际情况选择是否配置代理，包括git配置http/https代理、网络配置http/https代理

测试安装部署

源码下载
依次下载框架及用例集代码并切换到对应分支，其中branch当前支持openEuler-20.03
```
git clone $url
git checkout -f $branch
```
包含以下几个仓库：
https://gitee.com/src-openeuler/avocado
https://gitee.com/openeuler/avocado-vt
https://gitee.com/openeuler/tp-libvirt
https://gitee.com/openeuler/tp-qemu
avocado安装
依赖包安装：pip3 install -r requirements-selftests.txt
avocado框架安装： python3 setup.py install
avacado-vt安装
配置test-providers：配置libvirt、qemu
依赖包安装：pip3 install -r requirements.txt
avocado-vt插件安装： python3 setup.py install

用例集引导

引导tp-libvirt、tp-qemu用例集

avocado vt-bootstrap --vt-type qemu --vt-skip-verify-download-assets --yes-to-all
avocado vt-bootstrap --vt-type libvirt --vt-skip-verify-download-assets --yes-to-all

以上的部署过程总结成如下代码：

install_virttest() {
    local branch=$1

    cd "$srcdir/tp-qemu"
    git checkout -f "$branch"

    cd "$srcdir/tp-libvirt"
    git checkout -f "$branch"

    cd "$srcdir/avocado"
    git checkout -f "$branch"
    sed -i "s/^libvirt-python/#&/" requirements-selftests.txt
    pip3 install -r requirements-selftests.txt
    python3 setup.py install

    cd "$srcdir/avocado-vt"
    git checkout -f "$branch"
    sed -i "/^branch: /d" test-providers.d/io-github-autotest-qemu.ini
    sed -i "/^uri: /c uri: $srcdir/tp-qemu" test-providers.d/io-github-autotest-qemu.ini
    sed -i "/^uri: /a branch: $branch" test-providers.d/io-github-autotest-qemu.ini
    sed -i "/^branch: /d" test-providers.d/io-github-autotest-libvirt.ini
    sed -i "/^uri: /c uri: $srcdir/tp-libvirt" test-providers.d/io-github-autotest-libvirt.ini
    sed -i "/^uri: /a branch: $branch" test-providers.d/io-github-autotest-libvirt.ini
    rm -f test-providers.d/io-github-spiceqa-spice.ini
    pip3 install -r requirements.txt
    python3 setup.py install

    avocado vt-bootstrap --vt-type qemu --vt-skip-verify-download-assets --yes-to-all
    avocado vt-bootstrap --vt-type libvirt --vt-skip-verify-download-assets --yes-to-all
}

测试执行准备

虚拟机xml
需要提前准备好libvirt的xml，并在执行tp-libvirt相关用例前先define
测试虚拟机镜像准备
镜像的命名要求、支持镜像的范围，可参见配置/var/lib/avocado/data/avocado-vt/backends/libvirt/cfg/guestos-os.cfg
镜像存放路径为/var/lib/avocado/data/avocado-vt/images/，所在磁盘分区空间需要足够大，在用例执行过程中会先备份一下镜像，故此空间至少是镜像大小两倍以上。多机场景的用例，会通过virt-clone等方式克隆多份镜像，尤其需要注意镜像所在磁盘分区空间的大小
libvirt配置
设置/etc/libvirt/qemu.conf下user/group字段，配置为root
测试框架的base配置
基础配置，包含了虚拟机名称、镜像名称、镜像登录用户密码等。如果涉及迁移双机场景，需要配置迁移环境的配置信息。
```
/var/lib/avocado/data/avocado-vt/backends/libvirt/cfg/base.cfg
/var/lib/avocado/data/avocado-vt/backends/libvirt/cfg/guest-os.cfg
```

测试执行及结果分析

用例查看
在用例执行之前，先通过avocado list查看对应模块的用例，可同时用于检测框架部署的正确性。
如下几条命令，分别可查看qemu、libvirt以及通过多个条件组合过滤后的qemu_img模块的用例集。如果不做过滤用例集较大，命令执行稍微耗时多点（1分钟内）
```
avocado list --vt-type qemu --vt-machine-type arm64-pci
avocado list --vt-type libvirt --vt-machine-type arm64-pci 
avocado list qemu_img --vt-type qemu --vt-no-filter non-preallocated --vt-only-filter cluster_size_default --vt-machine-type arm64-pci
```

qemu用例执行

qemu用例可直接执行，不依赖libvirt的配置以及使用libvirt事先define一个虚拟机

示例：

avocado run type_specific.io-github-autotest-qemu.qemu_img.create.preallocated.cluster_size_default --vt-type qemu --vt-guest-os Guest.Linux.openEuler.20.03 --vt-machine-type arm64-pci

run-qemu-test-20210120

libvirt用例执行
libvirt用例执行之前，确保libvirt服务启动状态，同时需要基于前一章节中准备的虚拟机xml和镜像define一个测试虚拟机
示例：
```
avocado list virsh.reset --vt-type libvirt --vt-no-filter acl_test --vt-only-filter uuid_options --vt-machine-type arm64-pci
```
结果定位
框架执行的每个用例的日志，都会归档在logs_dir = ~/avocado/job-results下（具体可配置avocado.conf中logs_dir字段）。
参考前面qemu用例的执行示例图，可以看到日志的归档，关注JOB LOG文件，可以基于此开展失败分析定位。