Minimum System Requirements

  • Some flavor of Linux or MacOS with Docker installed

  • Memory: 16 GBs (debug builds)

  • Processor: 64-bit x86

  • Disk: 3 GB (image size)

Obtaining MOOSE and Running Tests

Images of MOOSE are currently hosted on Docker Hub in the repository herter4171/ubuntu-moose and herter4171/centos-moose for Ubuntu 18.04 and CentOS 7, respectively. The tag "latest" is kept current with the master branch of the repository, and the other tags are commit hashes to be used by codes with MOOSE as a Git submodule. Since the Docker image already has the framework compiled, it is possible to go from no extant, local copy of MOOSE to running the tests with a single command.

docker run -ti herter4171/ubuntu-moose:latest /bin/bash -c 'cd test; ./run_tests'

As one might expect, the same procedure applies for running a CentOS image.

docker run -ti herter4171/centos-moose:latest /bin/bash -c 'cd test; ./run_tests'

Extending the Image With MOOSE Apps

With the fully configured MOOSE framework in a Docker image, the next logical step is to extend this image with whichever MOOSE app is of interest. For example, consider another open sourced INL code known as BLACKBEAR. To build an image of BLACKBEAR, start by pasting the following in a new file with the name Dockerfile.

FROM herter4171/ubuntu-moose:latest


RUN git clone -b master ; \
cd blackbear ; \
git submodule update --init ; \
make -j $(grep -c ^processor /proc/cpuinfo)

WORKDIR /opt/blackbear

The first line of this file tells Docker to use MOOSE as a base image. The tag "latest" is used, because BLACKBEAR does not have MOOSE as a submodule. If it did, a commit hash would be used as the tag instead. From here, the RUN instruction handles the cloning, submodule checkout, and building steps. Last of all, to support end-use, the working directory is set to the root of the image's BLACKBEAR repository. To build an image using this Dockerfile, run the following.

docker build -t blackbear .

After this, like before, the tests can be ran with a single command.

docker run -ti blackbear ./run_tests

Hopefully this tutorial has shed some light on some advantages of containerizing MOOSE (or any other large and complex code-base) for development and end-use applications.