README.rst

nbi-jupyter-docker-stacks

A collection of docker jupyter notebook images used at https://www.ku.dk/english/.

Deployed notebooks are published at https://hub.docker.com/u/nielsbohr.

Overview

To build a particular notebook pass the directory name that contains the dockerfile to make:

make build/base-notebook

This will start the build procedure, the output will be a container image that is tagged with the word "edge".

To change this, override the TAG variable when calling a make target, e.g.:

make build/base-notebook TAG=latest

The Makefile also provides targets for test and push options. For example, first test the edge tagged image, then build an official latest tagged image and push it to the preset OWNER variable's dockerhub repository:

make test/base-notebook
make build/base-notebook TAG=latest
make push/base-notebook TAG=latest

To evaluate the entire stack, a target to 'build-all'/'test-all' is also available i.e.:

make build-all
make test-all

Note, the dgx1-notebook image tests, requires that the host system both has cuda 9.0 installed and the Nvidia-Docker 2 runtime environment added as a default to the docker daemon.json, e.g:

{
        "default-runtime": "nvidia",
        "runtimes": {
                "nvidia": {
                        "path": "nvidia-container-runtime",
                        "runtimeArgs": []
                }
        }
}