Dockerfiles to run the XtreemFS services in containers.

Before building the XtreemFS images, ensure that you have the current Debian baseimage by running

docker pull debian:bookworm-slim

The images for the DIR, MRC, and OSD services are derived from a common image named xtreemfs/xtreemfs-common. The containers are build from the XtreemFS Git repository at https://github.com/xtreemfs/xtreemfs.git. After cloning the repositoring by running

git clone https://github.com/xtreemfs/xtreemfs-docker.git
cd xtreemfs-docker

start with building the xtreemfs/xtreemfs-common through executing

docker build -t xtreemfs/xtreemfs-common xtreemfs-common/

to build the common image. Continue with the service specific images

docker build -t xtreemfs/xtreemfs-dir xtreemfs-dir/
docker build -t xtreemfs/xtreemfs-mrc xtreemfs-mrc/
docker build -t xtreemfs/xtreemfs-osd xtreemfs-osd/

Service configuration files are expected to be mapped into /xtreemfs_data. The config files have to be named dirconfig.properties, mrcconfig.properties, and osdconfig.properties. Example configuration files for each service are provided in the config-examples directory. A new service can be startet for instance by running

docker run -v /xtreemfs_data:/xtreemfs_data -p 32640:32640 -t -d xtreemfs/xtreemfs-osd:latest

while the config is stored in /xtreemfs_data/osdconfig.properties on the host. Network ports have to be mapped adequately while executing docker run. Default ports are 32636 for the MRC, 32638 for the DIR, and 32640 for the OSD. You have to ensure that services register with the correct address at the DIR service, this can be achieved by setting the "hostname" parameter for the MRC and OSD service.

The provided client images contains the XtreemFS FUSE client and can be used to build customized images for own services or run it interactively. The client image is also based on the xtreemfs-common images and can be generated by executing

docker build -t xtreemfs/xtreemfs-client xtreemfs-client/

You can run the XtreemFS client in an interactive container by executing

docker run -t -i --privileged xtreemfs/xtreemfs-client /bin/bash

Note that FUSE requires to run the container in the privileged mode.

Please consider the XtreemFS user guide at http://xtreemfs.org/userguide.php and the quick start tutorial at http://xtreemfs.org/quickstart.php for a general introduction to XtreemFS.