如何使用 Compass-CI 进行开源软件 PR 自动化测试？ step-by-step 教程

如何使用 Compass-CI 进行开源软件 PR 自动化测试？ step-by-step 教程

【免费下载链接】compass-ciCompass-CI 是一个可持续集成的开源软件平台。为开发者提供针对上游开源软件（来自 Github, Gitee, Gitlab 等托管平台）的测试服务、登录服务、故障辅助定界服务和基于历史数据的分析服务。项目地址: https://gitcode.com/openeuler/compass-ci

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

Compass-CI 是一个可持续集成的开源软件平台，为开发者提供针对上游开源软件（来自 Github, Gitee, Gitlab 等托管平台）的测试服务、登录服务、故障辅助定界服务和基于历史数据的分析服务。Compass-CI 基于开源软件 PR 进行自动化测试(包括构建测试，软件包自带用例测试等)，构建一个开放、完整的测试系统。

Compass-CI 自动化测试流程概览 📊

Compass-CI 的架构设计使其能够高效处理 PR 自动化测试流程，主要分为接入层、服务层、支撑层、数据层和资源层五个部分。

图：Compass-CI 架构图，展示了从接入层到资源层的完整测试流程

1️⃣ 准备工作：申请 Compass-CI 账号

要使用 Compass-CI 进行 PR 自动化测试，首先需要申请一个账号。

账号申请步骤：

1. 发送邮件至shdluan@163.com，邮件标题为 "apply account"
2. 邮件内容需包含：
   • my_name: 您的姓名
   • my_account: 账号名（使用英文/中文拼音，可以和数字，‘-’，‘_'组合，不可以有空格）
   • my_purpose: 申请目的
   • my_oss_commit: 您的开源贡献记录地址（如 GitHub 提交链接）
3. 附上您的 SSH 公钥（如~/.ssh/id_rsa.pub）

注意：使用 Compass-CI 需登录到客户端环境 account-vm，需要有一台加到 Compass-CI 白名单的且拥有固定 IP 的服务器。

2️⃣ 安装 Compass-CI 客户端

Compass-CI 将 lkp-tests 作为客户端，通过本地安装 lkp-tests 可以手动提交测试任务。

安装步骤：

git clone https://gitcode.com/openeuler/compass-ci cd compass-ci git clone https://gitee.com/compass-ci/lkp-tests.git cd lkp-tests make install source ~/.${SHELL##*/}rc

客户端依赖 Ruby 2.5 及以上版本，请确保您的系统已安装符合要求的 Ruby 环境。

3️⃣ 配置客户端环境

账号申请成功后，您将收到包含my_name、my_email、my_token和lab信息的反馈邮件。根据邮件提示进行配置：

# 设置默认配置 setup ~/.config/compass-ci/defaults/account.yaml # 配置实验室信息 setup ~/.config/compass-ci/include/lab/{{ lab }}.yaml

4️⃣ 提交 PR 测试任务

完成上述配置后，您可以开始提交 PR 测试任务了。

基本提交命令：

# 提交测试任务 lkp submit <your-pr-job.yaml>

任务提交后：

1. Compass-CI 会自动构建测试环境
2. 执行测试用例（包括构建测试、软件包自带用例测试等）
3. 生成测试报告并存储到测试结果数据库
4. 您可以通过门户网站查看测试结果

5️⃣ 查看测试结果与分析

测试完成后，您可以通过以下方式获取和分析测试结果：

1. 邮件通知：测试结果会通过邮件发送给您
2. 门户网站：登录 Compass-CI 门户网站查看详细测试报告
3. 结果分析工具：使用 Compass-CI 提供的结果分析服务进行历史数据对比和问题定位

常见问题解决 🛠️

Q: 如何将我的开源仓库添加到 Compass-CI 测试池？

A: 如果您的仓库不在平台测试覆盖范围内，需要将其注册到 upstream-repos。具体步骤参考 test-oss-project。

Q: 提交任务后没有收到测试结果怎么办？

A: 首先检查任务是否提交成功，然后确认您的邮箱设置是否正确。如有问题，可以联系 Compass-CI 支持团队。

总结

通过以上步骤，您可以轻松使用 Compass-CI 进行开源软件 PR 自动化测试。Compass-CI 提供了完整的测试流程，从任务提交到结果分析，帮助您提高代码质量和开发效率。开始使用 Compass-CI，让您的开源项目测试更加高效、可靠！

【免费下载链接】compass-ciCompass-CI 是一个可持续集成的开源软件平台。为开发者提供针对上游开源软件（来自 Github, Gitee, Gitlab 等托管平台）的测试服务、登录服务、故障辅助定界服务和基于历史数据的分析服务。项目地址: https://gitcode.com/openeuler/compass-ci