sednadevops/github-runner-build-image Docker 镜像 - 轩辕镜像

CI测试运行容器镜像文档

镜像概述和主要用途

本Docker镜像是专为持续集成(CI)测试场景设计的容器化解决方案，旨在提供标准化、隔离且可重复的测试环境。通过容器化技术，解决测试环境不一致、依赖冲突等问题，确保跨团队、跨环境的测试结果一致性，简化CI流程中的测试执行环节，提升测试效率和可靠性。

核心功能和特性

环境隔离

• 完全隔离的测试环境，避免与主机系统或其他测试任务产生依赖冲突
• 独立的文件系统和进程空间，确保测试过程不受外部环境干扰

标准化配置

• 内置常用测试工具和依赖（如Node.js、Python、JUnit等），版本统一可控
• 预配置基础测试环境，减少用户手动配置成本

轻量级设计

• 基于Alpine或Debian Slim等轻量级基础镜像构建，减少镜像体积和资源占用
• 优化启动速度，缩短测试任务准备时间

易于集成

• 支持主流CI/CD平台（Jenkins、GitHub Actions、GitLab CI、GitBucket等）
• 提供灵活的命令行接口，便于集成到自动化流水线中

可定制化

• 支持通过环境变量、配置文件或挂载卷自定义测试工具和依赖
• 允许扩展基础镜像，添加项目特定的测试环境配置

使用场景和适用范围

适用场景

• 单元测试自动化执行（如Java JUnit、Python pytest、JavaScript Jest等）
• 集成测试环境部署（模拟服务依赖，执行多模块协同测试）
• 代码质量检测（如SonarQube扫描、代码覆盖率分析）
• 跨版本/跨平台兼容性测试（在统一环境中验证不同依赖版本的兼容性）

适用范围

• 中小型软件开发团队的CI/CD流水线
• 个人开发者本地测试验证
• 开源项目自动化测试环节
• 对测试环境一致性要求高的企业级应用开发

使用方法和配置说明

基本使用流程

1. 拉取镜像
2. 挂载测试代码和依赖
3. 配置测试命令
4. 执行测试并获取结果

Docker部署示例

1. 基础运行命令（以Node.js项目为例）

bash
# 拉取镜像（假设镜像名为ci-test-runner:latest）
docker pull ci-test-runner:latest

# 运行测试（挂载当前项目目录到容器/app，执行npm test）
docker run -v $(pwd):/app \
  -w /app \
  ci-test-runner:latest \
  npm test

2. docker-compose配置示例

yaml
version: '3.8'
services:
  ci-test:
    image: ci-test-runner:latest
    volumes:
      - ./:/app  # 挂载项目代码到容器内/app目录
      - ./test-reports:/app/test-reports  # 挂载测试报告目录（可选）
    environment:
      - TEST_COMMAND="npm run test:ci"  # 自定义测试命令
      - LOG_LEVEL="info"  # 日志级别（debug/info/warn/error）
    working_dir: /app
    command: ${TEST_COMMAND}

配置参数说明

环境变量

数据卷挂载

集成到CI/CD平台示例

GitHub Actions配置示例

yaml
# .github/workflows/ci-test.yml
name: CI Test
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Run tests with CI test container
        run: |
          docker run -v $(pwd):/app \
            -e TEST_COMMAND="npm run test:ci" \
            -e LOG_LEVEL="debug" \
            ci-test-runner:latest

GitLab CI配置示例

yaml
# .gitlab-ci.yml
test_job:
  stage: test
  image: ci-test-runner:latest
  script:
    - docker run -v $(pwd):/app -w /app ci-test-runner:latest npm test
  artifacts:
    paths:
      - test-reports/  # 保存测试报告作为制品

注意事项

• 确保挂载的项目目录具有正确的读写权限，避免容器内权限不足导致测试失败
• 对于依赖网络的测试（如API测试），需配置容器网络模式（如--network=host或自定义网络）
• 大型项目建议使用缓存卷（CACHE_DIR）存储依赖，减少重复下载时间
• 生产环境使用时，建议指定具体镜像版本（如ci-test-runner:1.2.0）而非latest，确保环境稳定性