GAMA Docker Container

This project is a simple Docker image that contains a GAMA platform ready to use in headless mode within a minimal Alpine with Eclipse Adoptium OpenJDK 21 64-Bit Server VM container.

Getting Started

These instructions will cover usage information and for the docker container

Prerequisities

In order to run this container you’ll need to install docker.

Usage

Simple usage

The command to run the previously builded image is simple as below

docker run gamaplatform/gama:latest <custom argument for headless execution>

By default, if you don’t add argument after the container image, it will display the help message.

Shutdown the container

The container will stop automatically when the headless run will end.

Enter in the container

If you want to enter in bash inside the gama container, you will have to explicitly change the Docker Entrypoint of the container by this way

docker run -i -t --entrypoint /bin/bash <containerID>

Example

$ docker run --rm 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                   -- get the help of the command line
      -version                -- get the the version of gama
      -m [mem]                -- allocate memory (ex 2048m)
      -c                      -- start the console to write xml parameter file
      -v                      -- verbose mode
      -hpc [core]             -- set the number of core available for experimentation
      -socket [socketPort]    -- start socket pipeline to interact with another framework
      -p                      -- start pipeline to interact with another framework
      -validate [directory]   -- invokes GAMA to validate the models present in the directory passed as argument
      -test [directory]       -- invokes GAMA to execute the tests present in the directory and display their results
      -failed                 -- only display the failed and aborted test results
      -xml [experimentName] [modelFile.gaml] [xmlOutputFile.xml] -- only display the failed and aborted test results
 sh ./gama-headless.sh -xml experimentName gamlFile xmlOutputFile
      build an xml parameter file from a model

Environment Variables

/usr/lib/gama/headless/gama-headless.sh - Headless launch script (Default Entrypoint)

Useful File Locations

/opt/gama-platform - The installed version of GAMA
/opt/gama-platform/headless/gama-platform.sh - The helping file to launch GAMA Headless

Installing

Docker Hub pull

$ docker pull gamaplatform/gama:[latest|1.8.1|..]

To see all the available tags, see there.

Building

Clone this repository

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

Move in the cloned repository

cd ./gama.docker/tags/<any-tag-name>

Build the Docker image

docker build -t gama .

Built With

GAMA-Platform - https://github.com/gama-platform/gama/releases/
Docker - https://docker.com
AlpineOS - https://alpinelinux.org/
OpenJDK 17 - https://openjdk.java.net/

Find Us

Authors

Arthur Brugiere - RoiArthurB

See also the list of contributors who participated in this project.

License

This project is licensed under the GPL3 License - see the LICENSE.md file for details