clickhouse/install-rpm-test

RPM安装测试Docker镜像文档

镜像概述和主要用途

本Docker镜像提供了一个专用环境，用于验证RPM软件包的安装可行性。其核心功能是模拟真实系统环境，测试RPM包在安装过程中是否存在依赖缺失、权限错误、脚本执行异常等问题，帮助开发者和测试人员在软件发布前发现并解决安装相关问题。

核心功能和特性

• 纯净测试环境：提供隔离的系统环境，避免宿主系统配置对RPM安装测试的干扰
• 多发行版支持：可基于不同Linux发行版（如CentOS、Fedora、RHEL等）构建，适配各类RPM包测试需求
• 简化测试流程：无需手动配置测试环境，通过容器化方式快速启动测试
• 轻量级设计：镜像体积优化，启动速度快，资源占用低
• 安装过程捕获：完整记录RPM安装输出日志，便于问题定位

使用场景和适用范围

• RPM包开发者在本地验证新构建包的安装可用性
• CI/CD流水线中集成RPM包的自动化安装测试环节
• 软件打包团队对第三方RPM包进行兼容性验证
• 系统管理员测试自定义RPM包在目标服务器环境中的部署可行性

使用方法和配置说明

基本使用流程

1. 准备待测试的RPM软件包（本地文件系统中）
2. 通过Docker命令启动容器，挂载RPM包目录
3. 在容器内执行RPM安装命令进行测试
4. 根据输出日志判断安装是否成功

Docker部署示例

单RPM包测试

bash
# 将本地RPM包目录挂载到容器内的/rpm-test目录，执行安装测试
docker run -v /path/to/local/rpms:/rpm-test --rm rpm-test-image \
  rpm -ivh /rpm-test/your-package.rpm

批量RPM包测试

bash
# 在容器内批量测试目录中的所有RPM包
docker run -v /path/to/local/rpms:/rpm-test --rm rpm-test-image \
  sh -c "for rpm in /rpm-test/*.rpm; do rpm -ivh \$rpm; done"

指定发行版环境测试

（若镜像支持多发行版标签）

bash
# 使用CentOS 7环境测试RPM包
docker run -v /path/to/local/rpms:/rpm-test --rm rpm-test-image:centos7 \
  rpm -ivh /rpm-test/your-package.rpm

关键参数说明

• -v /path/to/local/rpms:/rpm-test：将本地存放RPM包的目录挂载到容器内的/rpm-test目录，使容器可访问待测试包
• --rm：测试完成后自动删除容器，避免残留
• rpm -ivh <package.rpm>：RPM安装命令，-i表示安装，-v显示详细信息，-h显示进度条

测试结果判断

• 安装成功：命令执行无错误输出，返回码为0
• 安装失败：命令输出中会显示具体错误信息（如"依赖检测失败"、"权限被拒绝"等），返回码非0

注意事项

• 确保待测试的RPM包与所选镜像的Linux发行版版本兼容
• 对于有特殊系统依赖的RPM包，可能需要在容器启动时额外挂载系统资源或设置环境变量
• 测试完成后建议查看完整安装日志，确认是否存在警告信息（即使安装返回码为0）