DOLFINX CI测试容器

1. 镜像概述

本Docker镜像专为DOLFINX项目设计，提供标准化的持续集成(CI)测试环境。DOLFINX是FEniCS项目的核心组件，用于求解偏微分方程的有限元数值模拟。该容器旨在确保DOLFINX代码提交过程中的测试一致性，简化自动化测试流程，支持跨平台验证和版本兼容性检查。

2. 核心功能与特性

• 预配置测试环境：集成DOLFINX测试所需的完整依赖栈，包括编译器、数值库、测试框架及第三方依赖
• 多测试类型支持：兼容单元测试、集成测试、性能测试等多种测试场景
• CI/CD平台兼容：无缝对接主流自动化测试平台（GitHub Actions、GitLab CI、Jenkins等）
• 版本控制：支持指定DOLFINX版本及依赖版本，确保测试环境可复现
• 轻量级设计：基于优化的基础镜像，平衡功能完整性与资源占用

3. 使用场景

• DOLFINX开发团队代码提交前的自动化验证
• 新版本发布前的多环境兼容性测试
• 第三方贡献代码的质量评估与集成测试
• 教学或科研环境中DOLFINX功能验证的标准化工具

4. 使用方法

4.1 基础运行命令

docker run --rm -v /path/to/dolfinx/source:/dolfinx \
  -e TEST_BRANCH=main \
  -e TEST_TYPE=unit \
  dolfinx-ci-test-container:latest

4.2 参数说明

4.3 CI平台集成示例（GitHub Actions）

在.github/workflows/test.yml中添加：

jobs:
  dolfinx-test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Run DOLFINX CI test
        uses: docker/run-action@v3
        with:
          image: dolfinx-ci-test-container:latest
          volumes:
            - ${{ github.workspace }}:/dolfinx
          env:
            TEST_BRANCH: ${{ github.ref_name }}
            TEST_TYPE: integration

5. 注意事项

• 确保宿主机Docker版本≥20.10，以支持容器资源限制功能
• 性能测试建议分配至少4GB内存和2核CPU资源
• 镜像版本需与DOLFINX目标测试版本匹配（如dolfinx-ci-test-container:v0.7.0对应DOLFINX v0.7.0）
• 敏感测试数据建议通过环境变量或加密卷挂载传递

6. 维护与更新

• 镜像定期随DOLFINX版本更新同步维护
• 依赖库安全更新通过基础镜像滚动更新实现
• 问题反馈请提交至DOLFINX项目GitHub仓库的ci-container标签Issue

7. 依赖说明

容器预装核心依赖包括：

• DOLFINX开发工具链（C++编译器、Python环境、CMake等）
• 数值依赖（PETSc、MPI、HDF5等）
• 测试框架（pytest、CTest、codecov等）
• 版本控制工具（Git、Subversion）