Building the Docker image

Github Actions automatically builds and tests new Docker images for MDMC. It does so ONLY IF files in the /build/Docker directory are changed, or if requirements.txt is changed. In this case, the pull request testing will automatically detect these changes, rebuild the image from the Dockerfile, test it, and then push it to mdmc/mdmc:ci-[branch] where [branch] is the name of the branch the image was built on. Note that the ‘slow’ build stage, the mdmc/engines image, is only built if its Dockerfile is changed.

If you need to rebuild the Docker image manually, go to the main directory for the source code then execute the command:

docker build -t mdmc/mdmc:experimental -f ./build/Docker/Dockerfile .

which will build the image and give it the tag mdmc/mdmc:experimental. Note that to push it to Docker hub, you need to be logged in as the mdmc user.

Please do not rebuild the Docker container using command line arguments (add them to the Dockerfile instead) or rebuild the container without updating the Dockerfile in the repository. This can cause issues and unintended behaviour, as well as making the container non-reproducible by others.

To push the Dockerhub experimental image to latest, do the following:

docker pull mdmc/mdmc:experimental
docker tag mdmc/mdmc:experimental mdmc/mdmc:latest
docker push mdmc/mdmc:latest