lbnlblum/ubuntu-2204-omc

OpenModelica CI测试镜像

概述

该Docker镜像基于OpenModelica构建，专为Modelica Buildings Library（MBL）的持续集成（CI）测试设计。它提供预配置的测试环境，确保MBL代码在开发流程中通过自动化测试验证，保障代码稳定性和模型正确性。

核心功能与特性

• 预装OpenModelica环境：包含运行MBL测试所需的OpenModelica稳定版本及依赖组件
• MBL测试依赖集成：内置MBL测试流程必要的库文件和工具链，简化环境配置
• CI流程兼容：支持主流CI平台（GitHub Actions、GitLab CI等）的自动化测试触发机制
• 环境一致性：提供隔离且可重复的测试环境，消除本地环境差异导致的测试结果偏差

使用场景

• MBL开发团队CI/CD流程：集成至代码仓库自动化测试环节，在代码提交或PR时自动执行验证
• 测试环境本地化复现：开发人员可在本地快速搭建与CI环境一致的测试环境，便于问题排查
• 第三方扩展兼容性测试：基于MBL开发扩展模块时，验证扩展功能与MBL核心的兼容性

使用方法

基本使用

拉取并启动镜像：

bash
docker pull docker.xuanyuan.run/openmodelica/mbl-ci-test:latest
docker run -it --rm docker.xuanyuan.run/openmodelica/mbl-ci-test:latest

挂载测试代码

将本地MBL代码目录挂载至容器内进行测试：

bash
docker run -it --rm -v /本地/mbl代码路径:/mbl docker.xuanyuan.run/openmodelica/mbl-ci-test:latest

执行测试命令

进入容器后运行MBL测试脚本：

bash
cd /mbl
./run_tests.sh  # 执行MBL测试套件

CI集成示例（GitHub Actions）

在.github/workflows/mbl-test.yml中配置：

yaml
jobs:
  mbl-ci-test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout MBL代码
        uses: actions/checkout@v4
      
      - name: 运行OpenModelica测试镜像
        uses: docker/run-action@v3
        with:
          image: docker.xuanyuan.run/openmodelica/mbl-ci-test:latest
          volumes: ${{ github.workspace }}:/mbl
          run: |
            cd /mbl
            ./run_tests.sh --coverage  # 执行测试并生成覆盖率报告

注意事项

• 确保Docker环境已分配足够资源（建议至少4GB内存）
• 本地测试时需保证挂载的MBL代码包含完整测试用例和依赖配置
• 镜像版本需与MBL测试需求匹配，可通过标签指定特定版本（如:v1.2.0）