Installation via Docker¶
Docker containers provide an easy-way to set up and distribute applications. They are also a safe and consistent environment which facilitate debugging and reproducibility of models.
gospl image contains all the dependencies and configuration files
required to run models. Users can start running model as soon as they
have downloaded the image, independently of the underlying operating system
available on on their machine.
Different version of the image can be pulled using a tag:
latesttag points to the github master branch and uses the latest release.
release tags such as
v0.2.0points to the specified version.
Depending on your operating system, you will be able to configure the docker application to set your resources: CPUs, memory, swap, or Disk image size.
Main command lines¶
Pulling the image¶
Once you have installed Docker on your system, you can
gospl official image as follow:
docker pull geodels/gospl:v0.2.0
You can list all the images available on your system as follow:
An image can be deleted as follow:
docker rmi geodels/gospl
Starting the container from a terminal¶
You can then start a docker container (an instance of an image):
docker run -d \ --name my_container \ -p 8888:8888 \ -v my_vol:/live/share \ geodels/gospl
You can access the container via your browser at the following address: http://localhost:8888
It is also possible to
ssh into the container as follow:
# Bash docker run -it -v my_vol:/live/share \ --entrypoint /bin/bash \ geodels/gospl:v0.2.0
You can list the containers currently existing on your machine by running:
docker ps -a
-a means “all container”. The
docker ps command only list
Docker containers can be stop (so that they do not use CPU or RAM resource):
docker stop my_container
They can also be deleted:
docker rm my_container
It’s a good idea to keep track of how many containers have been created as they can rapidly take a lot of space on your machine.
Kitematic is a program that provides a graphical user interface to
docker daemon and to Docker Hub.
Downloading a tagged image¶
The software is available for Windows, Mac OS X and Linux. Be aware that on linux the installation may differ depending on the distribution you are running.
Download and Install Kitematic
Open Kitematic and search for the tag corresponding to a specific the
Download the container by clicking on the create button.