Project Architecture

Submodules

The git repository contains multiple submodules, which are only necessary if you would like to build the resulting Docker Images on your own. So don't forget to checkout every submodule of the project:

git clone --recursive ssh://[email protected]/wakonp/jupyterhub-fhjoanneum.git

Or if you already cloned the project:

git submodule init

At this point you should have all projects available on your system and be able to modify the code.

Project Structure

The whole project is about the configuration of jupyterhub and the creation of a Docker Image, which is available at DockerHub. So if you just want to start the project without modifying jupyterhub, just download the image or start the application with the makefile.

docker pull walki12/jupyterhub

Furthermore, the project consists of two more Dockerfiles (teachernotebook and studentnotebook), which are located in the fhj-notebooks folder. These images should be started as docker services from the jupyterhub service at runtime. So if you want to use my already builded Notebooks, just pull them like the jupyterhub.

docker pull walki12/teachernotebook && docker pull walki12/studentnotebook

Adaped Dockerfiles

In the case you like to modify the Dockerfiles and build new Docker Images you always have to push them to dockerhub, because in the DockerSwarm all Images used as services should be available over a repository.

cd ./fhj-notebooks/teacher-notebook && docker build -t <dUser>/<iName> . && docker push <dUser>/<iName> cd ./fhj-notebooks/student-notebook && docker build -t <dUser>/<iName> . && docker push <dUser>/<iName>

Then you need to make sure all your nodes have the latest images, but after you build a new images always execute docker pull on the other nodes.