Docker镜像文档：软件包安装测试镜像

镜像概述和主要用途

该Docker镜像专为验证软件包安装可行性设计，提供标准化基础环境，用于测试各类软件包（如deb、rpm、tar.gz等）在不同配置下的安装过程。通过模拟真实部署场景，帮助用户提前识别软件包的依赖缺失、版本冲突或系统兼容性问题，适用于软件包发布前验证、依赖问题排查及自动化测试流程。

核心功能和特性

• 多格式支持：兼容deb（Debian/Ubuntu）、rpm（RedHat/CentOS）、tar.gz等主流软件包格式，覆盖多操作系统环境测试需求
• 依赖自动检查：内置依赖分析工具，可自动检测软件包安装所需前置依赖，输出缺失或冲突的依赖项详细信息
• 轻量级设计：基于Alpine或精简版Linux发行版构建，镜像体积<200MB，启动速度快，资源占用低
• 可配置测试策略：支持通过环境变量自定义依赖检查严格度（警告/报错）、日志输出级别等测试行为
• CI/CD集成友好：提供标准化命令行接口和可复用测试脚本，易于集成到Jenkins、GitLab CI、GitHub Actions等自动化流程

使用场景和适用范围

典型应用场景

• 软件包发布前验证：在正式发布前测试软件包在目标环境中的安装流程，确保用户端部署无障碍
• 跨平台兼容性测试：验证软件包在不同Linux发行版（如Ubuntu 20.04/22.04、CentOS 7/8）中的安装兼容性
• 依赖冲突排查：定位软件包安装失败原因，识别系统中已存在的依赖版本冲突或架构不兼容问题
• 自动化测试集成：作为CI/CD流水线的前置检查环节，在代码提交或构建阶段自动触发安装测试

适用人群

• 软件包维护者/开发者：验证自制软件包的安装可用性
• 测试工程师：执行软件包兼容性和依赖测试
• DevOps工程师：构建软件包部署前置检查流程
• 系统管理员：验证第三方软件包在生产环境中的部署可行性

使用方法和配置说明

获取镜像

docker pull [镜像仓库地址]/package-test-image:latest

基本使用示例

1. 测试deb软件包（严格依赖检查）

docker run -v /本地软件包路径/package.deb:/test/package.deb \
  -e PACKAGE_FORMAT=deb \
  -e CHECK_DEPENDENCIES=strict \
  [镜像仓库地址]/package-test-image:latest

说明：挂载本地deb包至容器/test目录，以严格模式检查依赖，缺失关键依赖时测试会终止并输出错误日志

2. 测试rpm软件包（调试模式）

docker run -v /本地软件包路径/package.rpm:/test/package.rpm \
  -e PACKAGE_FORMAT=rpm \
  -e LOG_LEVEL=debug \
  [镜像仓库地址]/package-test-image:latest

说明：开启debug日志模式，输出详细安装过程和命令执行结果，便于排查复杂依赖问题

docker-compose配置示例

version: '3'
services:
  package-test:
    image: [镜像仓库地址]/package-test-image:latest
    volumes:
      - ./local-packages:/test  # 挂载本地软件包目录至容器/test路径
    environment:
      - PACKAGE_FORMAT=deb
      - CHECK_DEPENDENCIES=normal
      - LOG_LEVEL=info
      - TARGET_PATH=/test  # 容器内软件包路径（需与volumes挂载路径一致）

配置参数说明