herter4171/ubuntu-moose

Ubuntu-Moose Docker镜像文档

一、镜像概述

1.1 镜像简介

本镜像基于Ubuntu系统构建，集成了MOOSE（Multiphysics Object-Oriented Simulation Environment）框架，旨在为MOOSE应用的开发、测试和运行提供便捷、一致的环境。镜像中预安装了MOOSE运行所需的全部依赖组件，无需用户手动配置。

1.2 主要用途

• 快速部署MOOSE框架及其运行环境
• 进行MOOSE应用的开发、测试与验证
• 确保跨环境的一致性，避免依赖配置差异导致的问题

二、核心功能和特性

• 基于Ubuntu系统：采用Ubuntu作为基础镜像，兼容性强，生态完善
• 集成MOOSE框架：内置完整的MOOSE框架，可直接运行MOOSE应用
• 自动更新机制：latest标签会随https://github.com/idaholab/moose/tree/master%E7%9A%84%60master%60%E5%88%86%E6%94%AF%E6%8F%90%E4%BA%A4%E5%90%8C%E6%AD%A5%E6%9B%B4%E6%96%B0
• 版本追溯支持：提供基于特定提交哈希的标签，满足绑定特定MOOSE版本的需求
• 全依赖预安装：包含MPICH、PETSc、Libmesh等MOOSE运行必需的依赖组件

三、使用场景和适用范围

• MOOSE应用开发与测试：适用于开发人员快速搭建开发环境，验证代码功能
• 特定版本兼容性验证：通过指定提交哈希标签，确保应用与特定MOOSE版本的兼容性
• 跨平台一致运行：在不同主机或CI/CD流程中提供统一的运行环境，避免"本地可运行，部署后异常"问题
• 新手快速上手：无需手动安装复杂依赖，直接通过镜像启动并运行MOOSE测试用例

四、使用方法和配置说明

4.1 快速启动

通过以下命令可快速启动镜像并运行MOOSE测试用例：

bash
docker run -ti herter4171/ubuntu-moose:latest /bin/bash -c 'cd test; ./run_tests'

4.2 标签说明

• latest标签：自动跟踪MOOSE GitHub仓库master分支的最新提交，每次master分支合并后更新
• 特定提交哈希标签：对应MOOSE仓库的历史提交哈希（如abc1234），用于绑定特定版本的MOOSE框架，确保环境一致性

4.3 依赖说明

镜像预安装以下MOOSE必需依赖组件：

• MPICH（并行计算库）
• PETSc（科学计算库）
• Libmesh（有限元分析库）
• 其他MOOSE运行依赖（如编译器、基础工具等）

4.4 详细配置

关于镜像的高级配置（如数据持久化、端口映射、环境变量设置等），可参考MOOSE官方文档-Docker安装页面。

五、注意事项

• 使用特定版本时，需通过MOOSE仓库提交历史获取目标版本的哈希值，并以该哈希作为镜像标签
• 运行耗时任务时，建议通过-d参数以后台模式启动容器，并结合docker logs查看输出
• 如需持久化数据，可通过-v参数挂载本地目录至容器内（如-v /local/data:/moose/data）