noaagfdl/ubuntu_libfms_gnu

libFMS构建环境Docker镜像

镜像概述

本镜像基于Ubuntu系统构建，专为编译libFMS（https://github.com/NOAA-GFDL/FMS%EF%BC%89%E6%8F%90%E4%BE%9B%E5%AE%8C%E6%95%B4%E4%BE%9D%E8%B5%96%E7%8E%AF%E5%A2%83%E3%80%82libFMS%E6%98%AFNOAA-GFDL%E5%BC%80%E5%8F%91%E7%9A%84%E8%80%A6%E5%90%88%E6%A8%A1%E5%BC%8F%E7%B3%BB%E7%BB%9F%E5%BA%93%EF%BC%8C%E5%B9%BF%E6%B3%9B%E7%94%A8%E4%BA%8E%E6%B0%94%E5%80%99%E6%A8%A1%E5%9E%8B%E3%80%81%E5%A4%A9%E6%B0%94%E9%A2%84%E6%8A%A5%E6%A8%A1%E5%9E%8B%E7%AD%89%E5%9C%B0%E7%90%83%E7%B3%BB%E7%BB%9F%E6%A8%A1%E5%BC%8F%E5%BC%80%E5%8F%91%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E9%A2%84%E5%AE%89%E8%A3%85%E6%89%80%E6%9C%89%E5%BF%85%E8%A6%81%E7%9A%84%E7%BC%96%E8%AF%91%E5%B7%A5%E5%85%B7%E5%92%8C%E4%BE%9D%E8%B5%96%E5%BA%93%EF%BC%8C%E7%AE%80%E5%8C%96libFMS%E7%9A%84%E6%9E%84%E5%BB%BA%E6%B5%81%E7%A8%8B%E3%80%82

核心功能与特性

• 基础环境：基于Ubuntu系统，提供稳定的操作系统基础
• 预配置依赖：包含构建libFMS所需的编译器（GCC等）、构建工具（Make、CMake）及各类依赖库
• 简化构建流程：无需手动安装和配置依赖，直接进入编译流程
• 环境一致性：确保不同平台上构建环境一致，解决"在我机器上能运行"问题
• 轻量级设计：在满足依赖需求的前提下，保持镜像体积优化

使用场景

• 科研人员本地编译和测试libFMS库
• 集成到CI/CD流程中实现libFMS的自动化构建
• 学术研究中快速搭建标准化的模式开发环境
• 教学场景中为学生提供统一的libFMS学习和实验平台

使用方法与配置说明

基本使用流程

1. 拉取镜像（假设镜像名称为noaa-gfdl/fms-build-env）

   bash
   docker pull docker.xuanyuan.run/noaa-gfdl/fms-build-env
   

2. 运行容器并挂载本地libFMS源代码目录

   bash
   docker run -it --rm -v /path/to/local/fms/source:/fms docker.xuanyuan.run/noaa-gfdl/fms-build-env
   

   • -v /path/to/local/fms/source:/fms：将本地libFMS源代码目录挂载到容器内的/fms目录
   • --rm：容器退出后自动删除
   • -it：提供交互终端，便于执行构建命令

构建libFMS示例

在容器内执行以下命令编译libFMS：

bash
# 进入源代码目录
cd /fms

# 创建并进入构建目录
mkdir -p build && cd build

# 运行CMake配置（根据libFMS实际构建要求调整参数）
cmake ..

# 执行编译（可使用-j参数指定并行编译任务数）
make -j4

# （可选）安装编译产物
make install

高级配置

如需自定义构建参数，可在运行容器时通过环境变量或命令行参数传递：

bash
# 示例：指定编译器版本或构建类型
docker run -it --rm -e CC=gcc-10 -e CXX=g++-10 -v /path/to/fms:/fms docker.xuanyuan.run/noaa-gfdl/fms-build-env

注意事项

• 确保本地源代码目录路径正确，建议使用绝对路径挂载
• 根据libFMS的具体版本要求，可能需要调整CMake参数或编译器版本
• 如需保留编译产物，可额外挂载输出目录（如-v /path/to/output:/fms/build）
• 对于大型项目，建议增加容器内存限制（如--memory=4g）以避免编译过程中内存不足