miccomcenter/bot

MICCoM代码持续集成Docker镜像

镜像概述

本镜像专为MICCoM代码（[***]

核心功能与特性

• 自动化构建流程：内置MICCoM代码编译环境，支持自动解析项目依赖、执行构建脚本，兼容主流构建工具
• 全面测试支持：集成单元测试、集成测试框架，可自定义测试套件，覆盖代码功能验证与性能评估
• 代码质量管控：包含静态代码分析、代码风格检查工具，确保代码符合MICCoM项目规范
• 版本控制集成：无缝对接Git等版本控制系统，支持基于提交/PR触发CI流程，自动关联代码变更
• 轻量高效设计：优化镜像体积，减少冗余依赖，缩短CI流程执行时间，降低资源占用

使用场景与适用范围

• 开发团队协作：在代码提交前自动验证功能正确性，减少集成冲突
• 开源项目维护：对社区贡献代码进行自动化审核，确保符合项目质量标准
• 多环境兼容性测试：可配置不同依赖版本，验证代码在多样化环境下的稳定性
• 定期集成验证：支持定时执行全量测试，及时发现潜在回归问题

使用方法与配置说明

基础使用（docker run命令）

bash
docker run -v /本地/miccom代码目录:/app/code \
  -e CI_PROJECT_PATH=/app/code \
  -e TEST_LEVEL=full \
  miccom-ci:latest

参数说明：

• -v /本地/miccom代码目录:/app/code：挂载本地MICCoM代码目录至容器内工作路径
• -e CI_PROJECT_PATH：指定容器内代码根目录（默认：/app/code）
• -e TEST_LEVEL：测试级别，可选值：basic（基础测试）、full（全量测试）、custom（自定义测试）

环境变量配置

Docker Compose配置示例

yaml
version: '3.8'
services:
  miccom-ci:
    image: miccom-ci:latest
    volumes:
      - ./local-miccom-code:/app/code
      - ci-cache:/app/cache  # 挂载缓存卷加速重复构建
    environment:
      - CI_PROJECT_PATH=/app/code
      - TEST_LEVEL=full
      - BUILD_TYPE=Release
      - CACHE_ENABLED=true
    command: ["ci-run"]  # 执行CI主流程命令

volumes:
  ci-cache:  # 持久化构建缓存

CI/CD平台集成示例（GitHub Actions）

yaml
name: MICCoM CI Pipeline
on: [push, pull_request]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Run MICCoM CI
        uses: docker://miccom-ci:latest
        with:
          args: ci-run
        env:
          CI_PROJECT_PATH: ${{ github.workspace }}
          TEST_LEVEL: full
          LOG_VERBOSITY: debug

注意事项

• 挂载代码目录需确保容器内用户对挂载路径有读写权限（建议使用-u $(id -u):$(id -g)指定用户ID）
• 全量测试（TEST_LEVEL=full）可能耗时较长，建议在关键版本节点或夜间定时任务中使用
• 构建缓存卷（如示例中的ci-cache）可显著提升重复构建效率，建议长期保留
• 对于复杂项目，可通过挂载自定义测试脚本至/app/custom-tests目录扩展测试能力