cci-job-client实战教程：从零开始搭建自动化测试工作流

cci-job-client实战教程：从零开始搭建自动化测试工作流

【免费下载链接】cci-job-clientA LKP jobs client for Compass-ci: submit LKP jobs and get the status of the LKP jobs项目地址: https://gitcode.com/openeuler/cci-job-client

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

cci-job-client是openEuler社区推出的一款LKP jobs客户端工具，专为Compass-ci设计，能够帮助开发者轻松提交LKP测试任务并实时获取任务状态，是搭建自动化测试工作流的得力助手。

一、快速了解cci-job-client核心功能

cci-job-client作为Compass-ci的LKP任务客户端，主要提供两大核心能力：

• 任务提交：通过简洁的命令行参数配置，快速将测试用例提交至Compass-ci服务器
• 状态跟踪：实时监控任务执行进度，支持自定义轮询间隔和超时时间设置

项目核心代码集中在src/目录下，其中src/submit_wait_job.py是实现任务提交与状态监控的关键脚本，src/wait_job_finish.py则专注于任务完成状态的跟踪。

二、环境准备：三步完成安装配置

2.1 安装依赖包

项目依赖已在requirements.txt中详细列出，通过以下命令快速安装：

pip install -r requirements.txt

2.2 克隆项目仓库

使用git命令克隆官方仓库到本地：

git clone https://gitcode.com/openeuler/cci-job-client cd cci-job-client

2.3 基础配置说明

配置文件主要集中在config/目录，其中config/logger.conf用于日志输出设置。核心参数包括：

• 目标系统信息（os、os_arch、os_version）
• 调度服务器地址（sched_host、sched_port）
• 任务监控参数（poll_interval、timeout）

三、实战操作：提交你的第一个测试任务

3.1 配置任务参数

在提交任务前，需要准备关键参数：

• os：测试运行的操作系统（如debian）
• os_arch：系统架构（如aarch64）
• os_version：系统版本号（通常来自rootfs制作时生成的时间戳）
• testbox：测试设备类型（如vm-2p8g）
• job_yaml：测试任务定义文件（如host-info.yaml）

3.2 使用脚本提交任务

项目提供了scripts/submit-jobs.sh脚本简化任务提交流程。典型使用示例：

# 进入脚本目录 cd scripts # 执行提交脚本 ./submit-jobs.sh \ --os debian \ --os_arch aarch64 \ --os_version 1766059721 \ --testbox vm-2p8g \ --job_yaml host-info.yaml \ --sched_host 172.168.177.42 \ --sched_port 30100 \ --poll_interval 10 \ --timeout 86400 \ --extra os_mount=initramfs

3.3 监控任务执行状态

任务提交后，系统会自动进入监控模式，每隔poll_interval秒（默认10秒）检查一次任务状态，直到任务完成或达到timeout时间（默认86400秒/24小时）。

监控逻辑由src/wait_job_finish.py实现，通过轮询Compass-ci服务器获取最新状态，确保你能实时掌握测试进度。

四、高级技巧：优化你的自动化测试流程

4.1 自定义任务配置

通过修改src/lib/constant.py中的常量定义，可以定制默认的任务参数，减少重复配置工作。例如调整默认轮询间隔或超时时间：

# 示例：修改默认轮询间隔为20秒 DEFAULT_POLL_INTERVAL = 20

4.2 集成到CI/CD流水线

cci-job-client特别适合集成到Jenkins等CI/CD平台。在Jenkins中配置步骤如下：

1. 在"构建步骤"中添加"执行shell"
2. 输入任务提交命令（参考3.2节示例）
3. 保存配置并触发构建

这种方式可以实现代码提交后自动执行测试，极大提升开发效率。

4.3 日志分析与问题排查

任务执行过程中产生的日志可通过config/logger.conf配置输出路径和级别。遇到问题时，建议先检查日志文件，重点关注：

• 任务提交阶段的服务器连接信息
• 测试执行过程中的状态变化
• 可能的错误提示和异常堆栈

五、常见问题解决

5.1 连接调度服务器失败

可能原因：sched_host或sched_port配置错误解决方法：检查scripts/submit-jobs.md中的服务器地址和端口，确保与Compass-ci服务器配置一致。

5.2 任务超时未完成

可能原因：测试用例执行时间过长或timeout设置过小解决方法：根据实际测试需求调整--timeout参数，单位为秒。对于长时间运行的任务，可适当增大该值。

5.3 依赖包安装问题

可能原因：网络问题或Python环境版本不兼容解决方法：确保Python版本符合setup.py中的要求，或使用虚拟环境隔离依赖。

六、总结

通过cci-job-client，开发者可以轻松构建从任务提交到状态监控的完整自动化测试流程。无论是独立使用还是集成到CI/CD系统，都能显著提升测试效率，确保软件质量。

项目的tests/目录包含了丰富的单元测试用例，如tests/test_parse_params_utils.py和tests/test_wait_job_finish.py，帮助你更好地理解和扩展工具功能。

现在就开始使用cci-job-client，让自动化测试为你的项目保驾护航吧！ 🚀

【免费下载链接】cci-job-clientA LKP jobs client for Compass-ci: submit LKP jobs and get the status of the LKP jobs项目地址: https://gitcode.com/openeuler/cci-job-client