Compass-CI 用户指南从注册到提交测试任务的终极教程【免费下载链接】compass-ciCompass-CI 是一个可持续集成的开源软件平台。为开发者提供针对上游开源软件来自 Github, Gitee, Gitlab 等托管平台的测试服务、登录服务、故障辅助定界服务和基于历史数据的分析服务。项目地址: https://gitcode.com/openeuler/compass-ci前往项目官网免费下载https://ar.openeuler.org/ar/Compass-CI 是一个可持续集成的开源软件平台为开发者提供针对上游开源软件来自 Github, Gitee, Gitlab 等托管平台的测试服务、登录服务、故障辅助定界服务和基于历史数据的分析服务。本教程将带您从账号注册到成功提交测试任务快速掌握 Compass-CI 的核心使用流程。一、Compass-CI 平台架构概览在开始使用前先了解 Compass-CI 的整体架构有助于您更好地理解任务流转过程。Compass-CI 采用分层设计从接入层到资源层形成完整的测试生态接入层支持 SSH、代码托管平台Gitee/GitHub/GitLab和门户网站多种接入方式服务层提供调试任务、测试任务、结果分析等核心服务支撑层负责任务调度、队列管理和数据处理数据层存储任务数据、设备信息和测试结果资源层包括物理机、虚拟机和各类依赖仓库二、账号注册与准备工作 2.1 注册账号要使用 Compass-CI 服务首先需要注册账号。详细的申请流程请参考官方文档user-guide/apply-account.zh.md2.2 安装客户端工具注册成功后需要安装 Compass-CI 客户端工具。推荐通过源码编译安装git clone https://gitcode.com/openeuler/compass-ci cd compass-ci make install-client安装完成后配置账号信息cci config --username your_account --email your_emailexample.com三、创建第一个测试任务 3.1 了解任务配置文件Compass-CI 使用 YAML 格式的配置文件定义测试任务。一个典型的任务配置文件包含测试套件、架构、操作系统版本等关键信息。示例配置文件路径user-client/jobs/3.2 编写任务配置创建一个简单的测试任务配置文件my_test_job.yaml内容如下suite: iperf category: benchmark os: openEuler arch: x86_64 testbox_group: vm-2p32g my_account: your_account其中suite指定测试套件如 iperf 网络性能测试category任务分类如 benchmark 基准测试os和arch指定测试环境的操作系统和架构testbox_group指定测试设备组my_account您的 Compass-CI 账号3.3 提交测试任务使用cci submit命令提交任务cci submit my_test_job.yaml提交成功后您将获得一个任务 ID用于后续查询任务状态和结果。四、任务监控与结果查看 4.1 查看任务状态提交任务后可以通过以下命令查看任务状态cci job status task_id您也可以在 Compass-CI 门户网站查看所有任务状态典型的任务列表界面如下4.2 分析测试结果任务完成后测试结果会自动存储并生成分析报告。您可以通过以下命令获取结果cci result show task_id测试结果包含详细的性能数据和对比分析例如五、任务调试与环境重现 如果测试任务失败或需要复现测试环境Compass-CI 提供了便捷的环境重现功能。参考文档user-guide/reproduce-the-job-environment/通过以下命令可以获取任务执行的详细环境配置cci job env task_id配置信息将包含测试所用的根文件系统、内核版本、设备信息等关键参数示例如下六、高级功能与最佳实践 ✨6.1 使用任务模板Compass-CI 提供了多种预定义的任务模板位于 user-client/maintain/您可以直接使用或根据需求修改。6.2 批量提交任务对于需要在多个环境中测试的场景可以使用矩阵测试功能批量提交任务。配置示例matrix: arch: [x86_64, aarch64] os: [openEuler-22.03, openEuler-23.09]6.3 故障辅助定界Compass-CI 提供故障辅助定界服务帮助定位测试失败原因。相关工具位于 sbin/git-bisect。七、总结通过本教程您已经掌握了 Compass-CI 的基本使用流程包括账号注册、任务配置、提交监控和结果分析。Compass-CI 为开源项目提供了强大的持续集成测试能力帮助开发者提高代码质量和稳定性。如需了解更多高级功能请参考官方文档doc/ 和 user-guide/。祝您在 Compass-CI 平台上测试愉快【免费下载链接】compass-ciCompass-CI 是一个可持续集成的开源软件平台。为开发者提供针对上游开源软件来自 Github, Gitee, Gitlab 等托管平台的测试服务、登录服务、故障辅助定界服务和基于历史数据的分析服务。项目地址: https://gitcode.com/openeuler/compass-ci创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考