OpenEuler UBS-test一站式UB ServiceCore测试框架完全指南【免费下载链接】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/想要快速掌握OpenEuler UBS-test测试框架吗这份终极指南将带你从零开始深入了解这个专为UB ServiceCore设计的强大测试工具。无论你是测试新手还是经验丰富的开发者都能在这里找到实用的操作技巧和最佳实践 什么是OpenEuler UBS-testOpenEuler UBS-test是一个专业的测试框架专门用于对UB ServiceCore进行全面的多组件特性测试和集成测试。它基于pytest框架构建提供了完整的测试基础设施和自动化测试能力是openEuler生态系统中不可或缺的测试工具。核心功能亮点 ✨多组件测试覆盖支持HCOM、UBSE、UBSocket、UBTurbo等多个UB ServiceCore组件的测试自动化测试执行通过pytest框架实现自动化测试执行和结果验证灵活的配置管理支持JSON和XML格式的资源配置文件远程节点测试通过SSH连接远程测试节点执行测试用例完整的日志追踪详细的测试步骤日志记录和结果分析 快速安装指南环境要求操作系统Linux推荐openEuler 22.03 LTS或更高版本Python版本Python 3.9网络要求能够SSH连接到测试节点5分钟快速安装 # 1. 克隆项目仓库 git clone https://gitcode.com/openeuler/ubs-test.git cd ubs-test # 2. 创建并激活虚拟环境 python3 -m venv .venv source .venv/bin/activate # 3. 安装项目依赖 pip install -e . # 4. 验证安装成功 pytest --version python3 -c from libs import TestCase; print(环境验证成功)依赖包一览表 依赖包版本要求用途说明pytest 7.4.0测试框架核心pytest-cov 4.1.0测试覆盖率报告pytest-asyncio 0.21.0异步测试支持pytest-xdist 3.3.0并行测试执行paramiko 3.0.0SSH远程连接 配置测试节点创建节点配置文件集成测试需要配置测试节点信息。推荐使用JSON格式的配置文件# 创建默认配置目录和文件 mkdir -p conf cat conf/env.json EOF { hosts: { 1: { ip: 192.168.1.100, port: 22, username: root, password: your_password, nodeId: Node0, params: { rack_path: /usr/local/softbus/ctrlbus } } }, devices: {}, global: {testbed_name: testbed} } EOF配置文件字段说明 字段必填说明ip是节点IP地址port是SSH端口默认22username是SSH用户名通常为rootpassword是SSH密码nodeId是节点标识符params否节点特定参数键值对字典 测试执行实战基本测试执行命令# 执行所有测试用例 pytest --resource-configconf/env.json # 执行测试并生成覆盖率报告 pytest --resource-configconf/env.json --covlibs --cov-reporthtml # 执行测试并显示详细输出 pytest --resource-configconf/env.json -v --tblong按测试标记筛选执行UBS-test支持多种测试标记方便灵活筛选标记说明示例命令unit单元测试pytest -m unitintegration集成测试pytest -m integrationvirt虚拟化测试pytest -m virtcontainer容器测试pytest -m containerslow慢速测试pytest -m slow使用示例# 执行集成测试需要节点配置 pytest --resource-configconf/env.json -m integration # 跳过慢速测试 pytest --resource-configconf/env.json -m not slow # 组合标记执行集成测试但跳过慢速测试 pytest --resource-configconf/env.json -m integration and not slow并行执行测试# 使用pytest-xdist并行执行自动检测CPU核数 pytest --resource-configconf/env.json -n auto # 指定并行进程数 pytest --resource-configconf/env.json -n 4 # 并行执行并显示每个进程的输出 pytest --resource-configconf/env.json -n 4 -v 测试覆盖范围详解UBS-test提供了全面的测试覆盖确保UB ServiceCore的各个组件都能得到充分验证测试模块测试内容重要性hcomHCOM API可用性测试核心通信组件ubseUB Pooling Management、UB Controller管理测试内存池化管理ubsocketSocket通信功能测试BRPC TCP/UB/MIX协议网络通信基础ubturbo内存池化、分布式功能、NUMA资源管理等测试性能优化关键️ 项目结构深度解析了解项目结构有助于更好地使用和扩展测试框架ubs-test/ ├── libs/ # 测试库核心代码 │ ├── core/ # 核心框架TestCase, fixtures, hook_runner, basecase │ ├── utils/ # 工具函数env_config, node_adapter, logger_compat │ ├── host/ # Linux SSH节点封装 │ └── modules/ # 测试AW模块 │ ├── ubsmem/ # UBSMem AW │ ├── hcom/ # HCOM AW │ ├── ubturbo/ # UBTurbo AW │ ├── ubsocket/ # UBSocket AW │ └── rackcontrol/ # RackControl AW ├── conf/ # 默认配置目录 ├── testcases/ # 测试用例目录 │ ├── ubscomm/ # 通信测试用例 │ ├── ubse/ # UBSE测试用例 │ ├── ubturbo/ # 内存池化等测试用例 │ └── ubsmem/ # UBSMem测试用例 ├── tests/ # 单元测试 ├── docs/ # 文档目录 └── examples/ # 使用示例 高级功能测试套批量执行UBS-test支持通过配置文件批量执行测试用例极大提高了测试效率创建测试套配置文件{ hook: libs.ubsmem.ubsshmem.ubs_mem_hook.UbsMemHook, tests: [ testcases/ubsmem/test_tc_ubs_mem_borrow_0007.py, testcases/ubsmem/test_tc_ubs_mem_borrow_0008.py ], params: { install_path: /home/ci/ubs_mem, log_bak_path: /home/ubs_mem_log_bak, cmc_package_path: /ko/matrix_shmem } }执行测试套# 基本执行 python run_suite.py testcases/ubsmem/ubsmem_suite.json # 透传pytest参数 python run_suite.py testcases/ubsmem/ubsmem_suite.json \ --resource-config../conf/env.json \ --no-cov -v \ -o log_clitrue --log-cli-levelDEBUG \ -W ignore::SyntaxWarning执行完成后会显示汇总信息 [run_suite] Passed: 20 | Failed: 2 | Total: 22 Hook机制测试套前置/后置操作测试套可以声明一个hook类在用例执行前自动完成环境准备在用例执行后执行清理Hook类实现示例class MyHook: Hook类示例 def _init_from_fixture(self, nodes, custom_params): Fixture注入入口 self.ssh_hosts nodes self.my_param custom_params.get(my_param, default_value) def beforePreTestSet(self): 在包内所有用例之前执行 # 安装软件、修改配置、启动服务等 ... def afterPostTestSet(self): 在包内所有用例之后执行 # 清理、恢复配置等 ... 常见问题解决方案Q1: pytest报错ModuleNotFoundError: No module named libs解决方案# 确保已安装项目依赖 pip install -e . # 或确保当前目录在Python路径中 export PYTHONPATH${PYTHONPATH}:$(pwd) pytest --resource-configtest_nodes.jsonQ2: 测试报错Failed to connect to node解决方案检查节点IP地址是否正确检查SSH用户名和密码是否正确测试网络连通性ssh root192.168.1.100检查目标节点SSH服务状态systemctl status sshdQ3: 如何查看测试覆盖率报告# 生成HTML覆盖率报告 pytest --covlibs --cov-reporthtml # 打开报告 xdg-open htmlcov/index.html # Linux open htmlcov/index.html # macOSQ4: 如何调试失败的测试用例# 显示详细traceback pytest --tblong -v # 只运行失败的测试 pytest --lf --tbshort # 进入PDB调试器 pytest --pdb # 打印测试执行过程中的变量 pytest -s --captureno 快速验证命令汇总在全新环境中按照以下步骤快速验证# 1. 克隆项目 git clone https://gitcode.com/openeuler/ubs-test.git cd ubs-test # 2. 创建虚拟环境 python3 -m venv .venv source .venv/bin/activate # 3. 安装依赖 pip install -e . # 4. 创建节点配置文件 cat test_nodes.json EOF { hosts: { 1: {ip: 192.168.1.100, port: 22, user: root, password: your_password, nodeId: Node0} }, devices: {}, global: {testbed_name: testbed} } EOF # 5. 验证配置 python3 -c from libs.utils.env_config import load_resource_config; cload_resource_config(test_nodes.json); print(fOK: {len(c[\hosts\])} nodes) # 6. 执行单元测试无需节点配置 pytest tests/ -v # 7. 执行集成测试需要节点配置 pytest --resource-configtest_nodes.json testcases/ -v -m integration # 8. 查看测试覆盖率报告 pytest --covlibs --cov-reporthtml xdg-open htmlcov/index.html 测试用例编写指南基本测试用例结构 测试用例文档说明 import pytest from libs.core import TestCase class TestExample(TestCase): 测试用例描述 CaseNumber: test_example_001 RunLevel: Level 1 EnvType: integration CaseName: 示例测试用例 PreCondition: 测试前置条件 TestStep: 测试步骤说明 ExpectedResult: 预期结果 Author: 作者 def setup_method(self): 测试前置设置 self.logStep(准备测试环境) # 初始化测试环境 def test_example_001(self): 测试主逻辑 self.logStep(执行测试步骤1) # 执行测试操作 result self.node.run({command: [ls -la], timeout: 30}) # 验证结果 self.assertTrue(result[returnCode] 0, 命令执行失败) def teardown_method(self): 测试后置清理 self.logStep(清理测试环境) # 清理测试环境使用pytest fixturesimport pytest def test_with_nodes(nodes, node_dict, resource): 使用fixtures注入测试资源 # nodes: 节点列表 # node_dict: 节点名称映射字典 # resource: 资源配置字典 controller nodes[0] agent nodes[1] if len(nodes) 1 else None # 执行测试操作 result controller.run({command: [hostname], timeout: 10}) assert result[returnCode] 0 代码规范与开发工具代码格式化与检查# 格式化代码 black . isort . # 类型检查 mypy libs/ # 运行pre-commit检查 pre-commit run --all-files 最佳实践建议1. 使用虚拟环境始终在虚拟环境中安装依赖避免污染系统Python环境。2. 配置文件管理将敏感信息如密码放在环境变量中而不是硬编码在配置文件中。3. 测试标记合理使用为测试用例添加合适的标记方便按需执行特定类型的测试。4. 日志记录在测试用例中使用self.logStep()记录关键步骤便于问题排查。5. 错误处理在测试用例中添加适当的错误处理和断言确保测试结果的准确性。 未来展望OpenEuler UBS-test作为UB ServiceCore的官方测试框架将持续演进更丰富的测试覆盖增加更多组件和场景的测试用例更好的性能优化支持更高效的并行测试执行更智能的测试报告提供更详细的分析和可视化报告更完善的CI/CD集成与主流CI/CD工具深度集成 贡献与支持我们欢迎所有形式的贡献如果你发现了bug或有改进建议请通过项目主页提交issue。如果你有新的测试用例或功能改进欢迎提交pull request。贡献流程Fork本仓库创建特性分支 (git checkout -b feature/AmazingFeature)提交更改 (git commit -m Add some AmazingFeature)推送到分支 (git push origin feature/AmazingFeature)开启Pull Request 总结OpenEuler UBS-test是一个功能强大、易于使用的测试框架为UB ServiceCore提供了全面的测试解决方案。通过本指南你已经掌握了从安装配置到高级使用的完整流程。现在就开始使用UBS-test为你的UB ServiceCore项目提供可靠的测试保障吧记住良好的测试是软件质量的基石而UBS-test正是你构建高质量UB ServiceCore应用的最佳伙伴【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考