apsiminitiative/apsimng-build

镜像概述

APSIM Next Generation构建依赖镜像是专为APSIM Next Generation（农业系统模拟模型）项目设计的Docker镜像，旨在提供该项目编译、构建和打包所需的完整依赖环境。通过预配置所有必要的系统库、开发工具和第三方依赖，该镜像解决了跨平台环境配置不一致的问题，简化项目构建流程，降低环境搭建成本。

核心功能与特性

• 完整依赖集成：预安装APSIM Next Generation项目构建所需的全部系统库（如Boost、SQLite等）、编译器（GCC/Clang）及构建工具（CMake、Ninja等）
• 版本一致性保障：固定依赖版本，避免因依赖版本差异导致的构建失败或运行时错误
• 跨平台兼容：基于主流Linux发行版（如Ubuntu）构建，支持x86_64等常见架构
• 轻量级优化：在满足依赖完整性的前提下，通过精简基础镜像和清理临时文件减少镜像体积

使用场景

• 本地开发环境：开发人员无需手动配置复杂依赖，直接使用镜像快速搭建一致的构建环境
• CI/CD流程集成：作为持续集成/持续部署流水线的构建环境，确保自动化构建过程的稳定性
• 测试环境搭建：在测试环境中快速部署标准化的构建环境，验证不同版本代码的构建兼容性
• 多版本并行开发：通过指定不同标签的镜像，支持同一项目不同分支的并行构建需求

使用方法### 基本构建命令

通过以下命令启动容器并执行项目构建：

bash
docker run --rm -v /path/to/local/project:/app apsimnextgen/build-deps:latest \
  bash -c "cd /app && cmake -S . -B build && cmake --build build"

• -v /path/to/local/project:/app：将本地APSIM Next Generation项目目录挂载到容器内/app路径
• --rm：容器退出后自动清理，避免残留临时文件
• bash -c "..."：容器内执行的构建命令（可根据项目实际构建流程调整）

参数说明

Docker Compose配置示例

在项目根目录创建docker-compose.build.yml：

yaml
version: '3.8'
services:
  build-env:
    image: apsimnextgen/build-deps:latest
    volumes:
      - ./:/app
    environment:
      - CMAKE_BUILD_TYPE=Release
      - CC=gcc
      - CXX=g++
    command: >
      bash -c "cd /app && 
               cmake -S . -B build -DCMAKE_BUILD_TYPE=Release && 
               cmake --build build --parallel 4"

启动构建：

bash
docker-compose -f docker-compose.build.yml up

注意事项

• 镜像标签选择：生产环境建议使用具体版本标签（如v2.10.0）而非latest，确保构建环境稳定性
• 本地文件权限：通过--user $(id -u):$(id -g)参数指定当前用户ID/组ID，避免容器内构建生成的文件归属root用户
• 依赖更新：定期拉取最新镜像（docker pull apsimnextgen/build-deps:latest）以获取安全更新和依赖版本升级
• 扩展定制：如需添加项目特定依赖，可基于此镜像创建自定义Dockerfile：

  dockerfile
  FROM apsimnextgen/build-deps:latest
  RUN apt-get update && apt-get install -y <additional-package> && rm -rf /var/lib/apt/lists/*