helics/buildenv

HELICS CI构建容器

概述

本镜像为HELICS（Hierarchical Engine for Large-scale Infrastructure Co-Simulation）项目的持续集成（CI）构建提供专用容器环境。镜像预配置了构建HELICS所需的全部依赖库、编译器工具链及构建系统，确保在自动化CI流程中能够一致、高效地完成HELICS的编译、测试与打包。

核心功能与特性

• 预配置构建环境：集成HELICS构建所需的所有依赖项（如Boost、ZeroMQ、MPI等），无需额外安装
• 多工具链支持：包含主流编译器（GCC、Clang）及构建系统（CMake、Make），适配不同构建需求
• CI流程优化：针对自动化构建流程优化，支持快速启动与资源高效利用
• 版本一致性：确保不同CI节点使用相同的构建环境，消除"本地可构建，CI失败"的环境差异问题

使用场景

• HELICS项目的GitHub Actions、GitLab CI、Jenkins等自动化CI/CD流程
• 开发环境中快速复现CI构建问题
• 多版本HELICS并行构建与测试

使用方法

基本使用

从镜像仓库拉取最新版本镜像：

bash
docker pull docker.xuanyuan.run/helics/ci-build:latest

在CI流程中直接使用（以GitHub Actions为例）：

yaml
jobs:
  build:
    runs-on: ubuntu-latest
    container:
      image: docker.xuanyuan.run/helics/ci-build:latest
    steps:
      - uses: actions/checkout@v4
      - name: Build HELICS
        run: |
          mkdir build && cd build
          cmake .. -DCMAKE_BUILD_TYPE=Release
          make -j$(nproc)
          make test

环境变量配置

自定义构建

如需自定义构建参数，可在容器内执行构建命令时指定：

bash
docker run -v $(pwd):/helics-src docker.xuanyuan.run/helics/ci-build:latest \
  bash -c "cd /helics-src && mkdir build && cd build && \
           cmake .. -DCMAKE_BUILD_TYPE=Debug -DHELICS_ENABLE_TESTS=ON && \
           make -j4 && make install"

注意事项

• 本镜像专为CI流程设计，不建议用作生产环境运行容器
• 定期拉取最新镜像以获取依赖库安全更新
• 如遇构建问题，可通过挂载本地代码目录进入容器调试：docker run -it -v $(pwd):/helics-src helics/ci-build:latest bash

版本信息

镜像标签遵循helics/ci-build:<helics-version>-<toolchain-version>格式，例如helics/ci-build:3.4.0-gcc11，可通过指定标签使用特定版本环境。