metsi/amanzi-tpls

镜像概述

该Docker镜像专为Amanzi多进程高性能计算（HPC）模拟器设计，集成了其运行和开发过程中所需的全部第三方库，旨在解决HPC环境下依赖配置复杂、版本冲突等问题，为Amanzi模拟器提供统一、可靠的运行与开发基础环境。

核心功能与特性

• 完整依赖集合：预安装Amanzi模拟器运行所需的全部第三方库，涵盖数学库、并行计算框架、I/O组件等核心依赖
• 版本兼容性保障：各依赖库版本经过验证，与Amanzi官方推荐版本严格兼容，避免版本冲突导致的运行异常
• 环境一致性：标准化依赖环境，确保开发、测试、生产等不同阶段的环境一致性，降低"本地可运行，部署后异常"的风险
• 简化部署流程：省去手动编译安装依赖的复杂步骤，通过Docker容器快速搭建可用环境，缩短Amanzi应用的部署周期

使用场景

• Amanzi模拟器开发：为开发者提供包含完整依赖的开发环境，支持代码编译、调试与单元测试
• Amanzi应用测试：在标准化环境中验证Amanzi模拟程序的功能正确性与性能表现
• HPC集群部署：作为Amanzi模拟器在HPC集群中的基础运行环境，简化分布式部署流程
• 教学与科研：用于学术环境中Amanzi模拟器的快速演示与教学实验，降低入门门槛

使用方法与配置说明

基本使用流程

1. 拉取镜像（假设镜像名称为amanzi-deps，标签为latest）：

   bash
   docker pull [镜像仓库地址]/amanzi-deps:latest
   

2. 启动容器：

   bash
   docker run -it --name amanzi-env [镜像仓库地址]/amanzi-deps:latest /bin/bash
   

   该命令将启动交互式容器，进入包含所有依赖的环境终端。

与Amanzi项目集成

在Amanzi项目构建过程中，可将该镜像作为基础镜像，通过Dockerfile集成到应用构建流程：

dockerfile
# 基于依赖镜像构建Amanzi应用
FROM [镜像仓库地址]/amanzi-deps:latest AS builder

# 设置工作目录
WORKDIR /opt/amanzi

# 复制Amanzi源代码
COPY ./source-code /opt/amanzi

# 执行编译构建
RUN cmake -DCMAKE_BUILD_TYPE=Release . && make -j$(nproc)

# 构建运行时镜像（可选，用于精简部署）
FROM [基础运行时镜像，如ubuntu:20.04]
COPY --from=builder /opt/amanzi/build/bin /usr/local/bin
ENTRYPOINT ["/usr/local/bin/amanzi-simulator"]

注意事项

• HPC环境适配：若需在支持MPI的HPC集群中使用，建议结合容器编排工具（如Singularity、Slurm）配置并行运行参数
• 版本选择：生产环境中建议使用特定版本标签（如v1.0.0）而非latest，确保依赖版本固定
• 资源配置：根据Amanzi模拟任务需求，启动容器时可通过--cpus、--memory等参数调整资源分配

环境变量说明

该镜像暂不涉及自定义环境变量配置，所有依赖库路径已预配置到系统环境变量（如LD_LIBRARY_PATH、PATH）中，可直接被Amanzi项目调用。