Run as Docker

#Maintaining a Docker based FITeagle instance

##preperation

• install a recent version of Docker. (we use docker 1.7)

apt-get install docker-io

installation

The installation is done using a helper sctipt (bin/docker_watcher.sh) that will create, update and run the Docker container.

• create a working directory (e.g. mkdir /opt/fiteagle && cd /opt/fiteagle )
• checkout the bootstrap repository git clone https://github.com/FITeagle/bootstrap.git
• create symlink to helper script ln -s bootstrap/bin/docker_watcher.sh .
• create fiteagle configuration files in (default: $PWD/dot_fitagle/)
• create & run FITeagle docker sudo ./docker_watcher.sh -f

configuration of deployment script

There are various configuration options that can be changed via a configuration file (docker_watcher.conf) in the current directory where the helper script is executed.

• _CONFIG_TRIGGER_FILE this file can be used to automatically rebuild the docker container. When this file is present when tzhe script is executed then the docker container will be rebuild.
• _CONFIG_LOCAL_BUILD when set to 1 the script uses a local Dockerfile to create the docker image instead of the version from github.
• _CONFIG_DOT_FITEAGLE this folder will be mappet into the docker container to store the fiteagle configuration files.

###example config-file

_CONFIG_TRIGGER_FILE="/tmp/fiteagle_integration-ok.txt"
_CONFIG_LOCAL_BUILD=0
_CONFIG_DOT_FITEAGLE="${PWD}/dot_fiteagle"
_CONFIG_FAST_REBUILD_FROM_CACHE=0
_CONFIG_EXPOSE_PORT_ARGS="-p 8443:8443"
_CONFIG_DOCKER_IMAGE_NAME="fiteagle2bin"

manual Docker image creation and execution

currently there is no pre-build version available in the docker hub however a Dockerfile is provided to easily build your own Docker image. The Dockerfile uses the bootstrap script to install the dependencies and the latest FITeagle binaries from our snapshot repository.

git clone https://github.com/FITeagle/bootstrap.git fiteagle-bootstrap
cd fiteagle-bootstrap/docker
docker build --no-cache --tag=fiteagle2bin .
docker run -d --name=ft2 -p 8443:8443

now the FITeagle2 service is reachable via https://localhost:8443/

##OLD FITeagle can be perfectly run inside a Docker container

currently there is no pre-build version available in the docker hub however we provide a Dockerfile to easily build your own Docker image. The Dockerfile uses the bootstrap script to install the dependencies and the latest FITeagle binaries from our snapshot repository.

The script docker_watcher.sh is used by our demo installation (demo.fiteagle.org) to periodically rebuild and restart the Docker instance when there are new commits in the repository that pass travis-ci build.