linuxsystemroles/test-harness

Linux System Roles 集成测试工具

镜像概述

linuxsystemroles/test-harness是针对Linux System Roles项目的集成测试工具，可自动化对相关仓库的拉取请求进行测试，在多种系统镜像上运行测试用例，并将测试状态同步至GitHub，支持并行运行与结果公开访问。

核心功能

• CI命令控制：通过PR评论触发测试（如[citest]重新测试所有机器，[citest bad]仅测试失败机器等）
• 多系统支持：兼容Fedora、CentOS等多种系统镜像
• 结果管理：测试结果上传至指定服务器并生成公开URL
• 状态同步：并行容器通过GitHub状态避免冲突
• OpenShift部署：支持在OpenShift环境中部署运行

使用场景

• Linux System Roles项目开发者验证拉取请求的功能兼容性
• 自动化CI/CD流程中集成测试环节
• 多系统环境下的角色功能验证与回归测试

配置说明

构建镜像

bash
sudo docker build -t linuxsystemroles/test-harness:latest .

配置文件（config.json）

需挂载/config目录，包含指定仓库、镜像、结果存储等信息的config.json，示例如下：

json
{
  "repositories": ["linux-system-roles/network", "linux-system-roles/selinux"],
  "images": [
    {"name": "fedora-27", "source": "https://download.fedoraproject.org/pub/fedora/linux/releases/27/CloudImages/x86_64/images/Fedora-Cloud-Base-27-1.6.x86_64.qcow2", "upload_results": true, "setup": "dnf install -yv python2 python2-dnf libselinux-python"}
  ],
  "results": {"destination": "user@example.org:public_html/logs", "public_url": "https://example.com/logs"},
  "logging": {"level": "WARNING", "filename": "/var/log/test-harness_HOSTNAME.log"}
}

密钥文件

需挂载/secrets目录，包含：

• github-token：GitHub访问令牌（需public_repo、repo:status等权限）
• id_rsa/id_rsa.pub：SSH密钥（用于上传结果）
• known_hosts：SSH已知主机文件

运行容器

容器需挂载/config、/secrets、/cache目录，并访问/dev/kvm加速虚拟化。

OpenShift部署

1. 创建项目：oc new-project linux-system-roles-test
2. 导入对象：oc create -f openshift-objects.yml
3. 配置权限：将服务账户加入privileged SCC（编辑scc privileged添加用户）
4. 创建ConfigMap与Secret：

   bash
   oc create configmap config --from-file=config.json
   oc create secret generic secrets --from-file=path/to/secrets
   

5. 导入镜像触发部署：oc import-image linux-system-roles-test