gamaplatform/gama

GAMA Docker容器

镜像概述和主要用途

GAMA Docker容器是一个包含GAMA平台的轻量级Docker镜像，基于Alpine Linux和Eclipse Adoptium OpenJDK 21 64-Bit Server VM构建，专为无头（headless）模式运行设计。该镜像提供即开即用的GAMA平台环境，适用于在无图形界面的服务器或自动化环境中执行GAMA模拟模型。

核心功能和特性

• 多版本支持：提供稳定版本、滚动版本和元标签版本，满足不同场景需求
• 无头执行：原生支持GAMA平台的无头模式，无需图形界面即可运行模拟模型
• 自动生命周期管理：无头任务执行完毕后容器自动停止，资源利用高效
• 灵活配置：支持通过命令行参数自定义GAMA执行行为（内存分配、核心数设置等）
• 轻量级基础：基于Alpine Linux，镜像体积小，启动速度快
• 交互式调试：支持通过修改入口点进入容器内部进行环境调试

使用场景和适用范围

• 服务器端模拟：在无图形界面的服务器环境中运行GAMA模型
• 批量计算任务：自动化执行多组参数或多模型的批量模拟
• 持续集成测试：集成到CI/CD流程中，对GAMA模型进行自动化验证和测试
• 科研计算：支持长时间运行或大规模并行的GAMA模型计算
• 开发环境：作为GAMA无头模式开发和调试的标准化环境

使用方法和配置说明

前提条件

运行容器前需安装https://docs.docker.com/get-started/get-docker/%E3%80%82

标签说明

https://hub.docker.com/r/gamaplatform/gama%E6%8F%90%E4%BE%9B%E4%BB%A5%E4%B8%8B%E7%B1%BB%E5%9E%8B%E6%A0%87%E7%AD%BE%EF%BC%9A

• 稳定版本：从https://hub.docker.com/layers/gamaplatform/gama/1.8-rc2/images/sha256-76035a577c8541ca6610a949cc58a4e76a7423da2e89c140a67cd75ae3e29efc?context=explore%E5%BC%80%E5%A7%8B%E7%9A%84%E5%AE%98%E6%96%B9%E5%8F%91%E5%B8%83%E7%89%88%E6%9C%AC
• 滚动版本：
  • alpha：基于最新GitHub代码构建的开发版本，未经官方测试
• 元标签：
  • latest：指向最新官方稳定版本

基本使用

运行容器的基础命令：

bash
docker run docker.xuanyuan.run/gamaplatform/gama:latest <无头执行参数>

若未指定参数，容器默认输出GAMA无头模式帮助信息。

容器生命周期管理

• 自动停止：无头任务执行完成后容器将自动停止
• 交互式进入：如需进入容器bash环境，需修改入口点：

bash
docker run -i -t --entrypoint /bin/bash docker.xuanyuan.run/gamaplatform/gama:latest

使用示例

获取GAMA无头模式帮助信息：

bash
docker run --rm docker.xuanyuan.run/gamaplatform/gama:1.8.1 -help

输出示例：

gama-headless.sh

* GAMA version 1.8.1                                             *
* http://gama-platform.org                                       *
* (c) 2007-2019 UMI 209 UMMISCO IRD/SU & Partners                *

 Welcome to Gama-platform.org version GAMA 1.8.1
sh ./gama-headless.sh [Options] [XML Input] [output directory]

List of available options:
      -help                   -- 获取命令行帮助
      -version                -- 获取GAMA版本信息
      -m [mem]                -- 分配内存（例如 2048m）
      -c                      -- 启动控制台以编写XML参数文件
      -v                      -- verbose模式
      -hpc [core]             -- 设置实验可用核心数
      -socket [socketPort]    -- 启动与其他框架交互的socket管道
      -p                      -- 启动与其他框架交互的管道
      -validate [directory]   -- 验证指定目录中的模型
      -test [directory]       -- 执行指定目录中的测试并显示结果
      -failed                 -- 仅显示失败和中止的测试结果
      -xml [experimentName] [modelFile.gaml] [xmlOutputFile.xml] -- 从模型构建XML参数文件
 sh ./gama-headless.sh -xml experimentName gamlFile xmlOutputFile

配置参数说明

GAMA无头模式支持以下核心参数（完整列表见帮助信息）：

环境变量与入口点

• 默认入口点：/usr/lib/gama/headless/gama-headless.sh（GAMA无头启动脚本）
• 可通过--entrypoint参数自定义入口点，例如进入bash环境

重要文件位置

• /opt/gama-platform：GAMA平台安装根目录
• /opt/gama-platform/headless/gama-platform.sh：无头模式启动辅助脚本（详情参见GAMA无头运行文档）

安装方法

从Docker Hub拉取

bash
docker pull docker.xuanyuan.run/gamaplatform/gama:[版本标签]

示例（拉取最新稳定版）：

bash
docker pull docker.xuanyuan.run/gamaplatform/gama:latest

所有可用标签见https://hub.docker.com/r/gamaplatform/gama/tags%E3%80%82

本地构建

1. 克隆仓库：

bash
git clone https://github.com/gama-platform/gama.docker

2. 进入目标版本目录：

bash
cd ./gama.docker/tags/<标签名称>

3. 构建镜像：

bash
docker build -t gama .

技术架构

• 基础组件：
  • GAMA-Platform（核心模拟引擎）
  • Alpine Linux（基础操作系统）
  • Eclipse Adoptium OpenJDK 21 64-Bit Server VM（Java运行环境）
  • Docker（容器化平台）

相关资源

• GitHub：https://github.com/gama-platform
• Docker Hub：https://hub.docker.com/r/gamaplatform/gama
• GAMA官网：https://gama-platform.github.io/

作者

• Arthur Brugiere - https://github.com/RoiArthurB

完整贡献者列表见https://github.com/gama-platform/gama.docker/contributors%E3%80%82

许可证

本项目基于GPL3许可证授权 - 详见LICENSE.md文件。