OpenEuler UBS-test测试框架详解：从零开始掌握多组件集成测试

【免费下载链接】ubs-testThe ubs-test project is used to test the UB ServiceCore and provides feature tests and scenario tests.项目地址: https://gitcode.com/openeuler/ubs-test

前往项目官网免费下载：https://ar.openeuler.org/ar/

UBS-test是OpenEuler社区专为UB ServiceCore打造的专业测试框架，提供全面的多组件特性测试与集成测试能力。该框架基于pytest构建，支持虚拟化、容器等核心功能的自动化测试，帮助开发者快速验证UB ServiceCore组件的兼容性与稳定性。

为什么选择UBS-test测试框架？

UBS-test测试框架具备三大核心优势，让多组件集成测试变得简单高效：

1. 完整的测试生态支持

• 模块化架构：通过libs/core/提供Testcase和TestRunner等核心组件，兼容legacy UniAutos框架
• 丰富测试类型：覆盖虚拟化特性测试（testcases/ubsvirt/）、容器功能测试（testcases/container/）等场景
• 自动化能力：支持测试用例自动发现、执行与结果收集，减少人工干预

2. 灵活的配置与执行方式

测试框架支持两种配置方式，满足不同测试环境需求：

默认配置方式

项目会自动读取conf/env.json配置文件，包含测试节点信息、资源参数等关键配置。典型配置示例：

{ "nodes": [ { "name": "node1", "ip": "192.168.1.10", "ssh_user": "root", "ssh_port": 22 } ] }

自定义配置方式

通过命令行参数指定配置文件路径，适应多环境测试需求：

pytest --env-config custom_env.json

3. 全面的测试用例覆盖

UBS-test提供109个多组件集成测试用例，覆盖核心业务场景：

• 内存池管理测试：testcases/ubturbo/mempooling/目录下包含内存池创建、回滚、迁移等场景测试
• 虚拟化功能测试：testcases/ubsvirt/virtualization/提供VM迁移、内存碎片等专项测试
• 分布式高可用测试：testcases/ubse/Distributed_High_Reliability/验证系统在异常场景下的稳定性

快速上手：UBS-test测试框架使用教程

环境准备要求

开始使用UBS-test前，需确保测试环境满足以下条件：

• Python 3.8+环境
• pytest 7.4.0+测试框架核心
• SSH可访问的测试节点（用于集成测试）
• 安装依赖包：pip install -r requirements.txt

框架安装步骤

1. 克隆代码仓库

git clone https://gitcode.com/openeuler/ubs-test cd ubs-test

2. 配置测试环境

创建默认配置文件：

cat > conf/env.json << 'EOF' { "nodes": [ { "name": "test-node", "ip": "your-node-ip", "ssh_user": "root", "ssh_port": 22, "password": "your-password" } ] } EOF

3. 执行集成测试

使用默认配置执行全部集成测试：

pytest -m integration

指定配置文件执行测试：

pytest -m integration --env-config ./custom_config.json

高级使用技巧

选择性执行测试用例

通过标记过滤特定类型测试：

# 仅执行内存池相关测试 pytest -m mempooling # 执行集成测试但跳过慢速测试 pytest -m "integration and not slow"

查看测试报告

测试完成后生成详细报告：

pytest --html=report.html -m integration

UBS-test框架核心组件解析

测试用例组织

测试用例采用模块化结构，主要分布在testcases/目录下：

• ubturbo/： Turbo相关功能测试，如内存池管理、overcommit等
• ubsvirt/：虚拟化特性测试，包含VM迁移、XML配置验证等
• ubse/：UB ServiceCore核心功能测试，如分布式高可用、内存 numa 管理

核心测试库

框架核心代码位于libs/core/，提供基础测试能力：

• base.py：定义TestCase基类，封装通用测试方法
• fixtures.py：提供pytest fixtures，管理测试前置条件
• hook_runner.py：支持测试钩子，实现测试流程自定义

测试工具集

tools/poc_tools/提供实用测试辅助工具：

• create_vm.py：快速创建测试用虚拟机
• vm_monitor.py：实时监控VM资源使用情况
• mem_free.py：内存资源释放工具

常见问题解决

测试节点连接失败

问题：执行测试时提示SSH连接超时
解决：检查conf/env.json中节点IP、端口和认证信息，确保测试节点网络可达

测试用例执行缓慢

问题：集成测试耗时过长
解决：使用-x参数在首个失败用例处停止，或通过-k指定特定用例：

pytest -m integration -k "test_memory_pooling_first_return_success"

环境依赖缺失

问题：测试过程中提示模块不存在
解决：重新安装依赖包：

pip install --upgrade -r requirements.txt

总结

UBS-test作为OpenEuler生态中的重要测试框架，为UB ServiceCore提供了全面的多组件集成测试解决方案。通过本文介绍的从零开始的使用指南，您可以快速掌握测试环境搭建、用例执行和结果分析的全流程。无论是虚拟化特性验证还是容器功能测试，UBS-test都能提供稳定可靠的测试能力，帮助开发者提升软件质量。

想要深入了解更多测试场景和高级功能，可以参考项目文档：docs/index.md，或查看完整测试用例集合：testcases/。

【免费下载链接】ubs-testThe ubs-test project is used to test the UB ServiceCore and provides feature tests and scenario tests.项目地址: https://gitcode.com/openeuler/ubs-test