Docker image of Alpine Linux with MPICH -- portable implementation of Message Passing Interface (MPI) standard. Designed for MPI program development and deployment.
Provide solution for MPI Cluster Automation with Docker containers using either Docker Compose or Docker Swarm Mode.
Best Paper Award at IEEE CCWC 2017
N. Nguyen and D. Bein, "Distributed MPI cluster with Docker Swarm mode," 2017 IEEE 7th Annual Computing and Communication Workshop and Conference (CCWC), Las Vegas, NV, USA, 2017, pp. 1-7.
Image usage instruction: https://hub.docker.com/r/nlknguyen/alpine-mpich
Distributed MPI cluster setup instruction: https://github.com/NLKNguyen/alpine-mpich/tree/master/cluster
Automated build with Travis CI and push to Docker Hub https://hub.docker.com/r/nlknguyen/alpine-mpich
TODO Feb 23, 2019: Current failed checks are due to new style rules for shell scripts using shellcheck tool. All shell scripts need to be updated to pass the build. Most of shellcheck's recommendations are legit.
base image
(Dockerfile) : contains MPICH and essential build tools. Intended to be used as development environment for developing MPI programs.
onbuild image
(Dockerfile) : inherits base image with network setup for cluster. Can be used like base image but intended to be used to build image that contains compiled MPI program in order to deploy to a cluster.
cluster
(project scaffolder) : is a directory containing a setup for deploying MPI programs to a cluster of containers. Include a runner script to automate Docker commands.
Below is instruction for building the Docker image yourself if you don't want to use the pre-built base or onbuild image.
The images are prebuilt and hosted at Docker Hub, but in case you want to build them yourself:
$ git clone https://github.com/NLKNguyen/alpine-mpich
$ cd alpine-mpich
$ docker build -t nlknguyen/alpine-mpich base/
$ docker build -t nlknguyen/alpine-mpich:onbuild onbuild/
Since the onbuild image inherits the base image, if you use a different tag name (nlknguyen/alpine-mpich
), you must change the first line in onbuild/Dockerfile
to inherits FROM
your custom tag name.
In order to customize the base image at build time, you need to download the Dockerfile source code and build with optional build arguments (without those, you get the exact image as you pull from DockerHub), for example:
$ git clone https://github.com/NLKNguyen/alpine-mpich
$ cd alpine-mpich
$ docker build --build-arg MPICH_VERSION="3.2b4" -t my-custom-image base/
These are available build arguments to customize the build:
REQUIRE
space-separated names of packages to be installed from Alpine main package repository before downloading and installing MPICH. Default="sudo build-base openssh"
MPICH_VERSION
to find which version of MPICH to download from here. Default="3.2"
MPICH_CONFIGURE_OPTIONS
to be passed to./configure
in MPICH source directory. Default="--disable-fortran"
(let me know if you need Fortran, I can certainly add it by default)MPICH_MAKE_OPTIONS
to be passed tomake
after the above command. Default is emptyUSER
non-root user with sudo privilege and no password required. Default=mpi
WORKDIR
main working directory to be owned by default user. Default=/project
See MPICH documentation for available options
Should you need more than that, you need to change the Dockerfile yourself or send suggestion/pull requests to this GitHub repository.
Feedbacks are always welcome. For general comments, use the comment section at the bottom of this image page on Docker Hub
Use this GitHub repository issues
Suggestions and pull requests are awesome.
Copyright © Nikyle Nguyen