dolfinx/dev-env

dolfinx构建依赖镜像文档

概述

本镜像为构建dolfinx（一款高性能有限元分析库）提供完整的依赖环境，预集成了所有必要的编译工具、库文件及系统依赖，旨在解决手动安装依赖的复杂性，简化dolfinx的构建流程，确保跨环境的构建一致性。

核心功能与特性

1. 完整依赖集成

• 预安装dolfinx构建所需的全部依赖，包括但不限于：C++编译器（GCC/Clang）、MPI库、PETSc、BLAS/LAPACK、CMake、Python开发环境及相关科学计算库。
• 涵盖从基础系统工具到高级数值计算库的全链条依赖，无需额外手动配置。

2. 环境一致性保障

• 标准化构建环境，避免因系统差异导致的"在我机器上能运行"问题，确保不同开发者、不同平台下的构建结果一致。

3. 简化构建流程

• 省略手动安装依赖步骤，开发者可直接基于镜像启动容器并执行dolfinx构建命令，大幅缩短环境准备时间。

使用场景

1. dolfinx开发者环境

• 供dolfinx开发者快速搭建本地构建环境，专注于代码开发而非依赖配置。

2. CI/CD流程集成

• 作为自动化构建流程（如GitHub Actions、GitLab CI）的基础环境，确保每次代码提交都能在一致环境中完成构建验证。

3. 教学与研究环境

• 用于高校、研究机构的有限元方法教学或科研项目，统一学生/研究人员的开发环境，降低环境配置门槛。

使用方法

1. 拉取镜像

通过Docker Hub或私有仓库拉取镜像（假设镜像标签为dolfinx/build-deps:latest）：

bash
docker pull dolfinx/build-deps:latest

2. 启动容器

运行容器并挂载dolfinx源码目录（假设本地源码路径为/path/to/dolfinx-source）：

bash
docker run -it --rm -v /path/to/dolfinx-source:/dolfinx dolfinx/build-deps:latest bash

• -it: 交互式终端模式
• --rm: 容器退出后自动删除
• -v: 将本地源码目录挂载到容器内/dolfinx路径，便于在容器内访问源码

3. 构建dolfinx

在容器内执行dolfinx标准构建流程：

bash
cd /dolfinx
mkdir build && cd build
cmake ..
make -j$(nproc)

配置说明

挂载源码目录

为避免在容器内重复克隆源码，建议通过-v参数将本地dolfinx源码目录挂载到容器内，如上述docker run命令所示。

自定义构建参数

若需调整构建配置（如指定编译器、开启/关闭特定功能），可在cmake命令中添加对应参数，例如：

bash
cmake -DCMAKE_CXX_COMPILER=g++-11 -DBUILD_SHARED_LIBS=ON ..

持久化构建结果

如需保留构建产物，可额外挂载构建输出目录：

bash
docker run -it --rm -v /path/to/dolfinx-source:/dolfinx -v /path/to/build-output:/dolfinx/build dolfinx/build-deps:latest bash

构建产物将保存在本地/path/to/build-output目录中。

注意事项

• 确保本地Docker环境已正确安装并运行。
• 若需构建特定版本的dolfinx，建议使用对应版本标签的依赖镜像（如dolfinx/build-deps:v0.7.0）以匹配依赖版本。
• 容器内默认非root用户运行，如需权限操作可通过--user root参数调整。